הפונקציה GetDlgCtrlID מחזירה את המזהה של הפקד שצוין.
int GetDlgCtrlID ( HWND hwndCtl / / לטפל של פקד);
אם הפונקציה מצליחה, הערך המוחזר הוא המזהה של הפקד.
אם הפעולה תיכשל, הערך המוחזר הוא אפס. לדוגמה, ערך לא חוקי עבור הפרמטר hwndCtl , תגרום הפונקציה להיכשל. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.
GetDlgCtrlID מקבל נקודות אחיזה של חלון צאצא, כמו גם נקודות האחיזה של פקדי תיבות דו-שיח. יישום מגדירה את המזהה עבור חלון צאצא כאשר הוא יוצר את החלון על-ידי הקצאת הערך של מזהה הפרמטר hmenu בעת קריאה הפונקציה של createwindow ליצירת או CreateWindowEx.
למרות GetDlgCtrlID עשויה להחזיר ערך אם hwndCtl מזהה חלון ברמה העליונה, windows ברמה העליונה יכולים להיות מזהים ערך ההחזרה הוא מעולם לא חוקי.
חלונות CE: מזהי תקפים רק עבור חלונות צאצאים.
ניתן להגדיר את המזהה על-ידי העברת זה ב כפרמטר hMenu לפונקציה CreateWindowEx . שניתן גם יהיה להגדיר ולהשתמש שאוחזרו על-ידי קריאה בפונקציות GetWindowLong ו- SetWindowLong עם הפרמטר nIndex בחר GWL_ID.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
סקירה כללית של תיבות הדו-שיח, פונקציות של תיבת הדו-שיח, של createwindow ליצירת, CreateWindowEx, GetDlgItem