GetDlgCtrlID-Funktion (winuser.h)

Artikel
08/27/2023

Ruft den Bezeichner des angegebenen Steuerelements ab.

Syntax

int GetDlgCtrlID(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Steuerelement.

Rückgabewert

Typ: int

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der Bezeichner des Steuerelements.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Ein ungültiger Wert für den hwndCtl-Parameter führt beispielsweise dazu, dass die Funktion fehlschlägt. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

GetDlgCtrlID akzeptiert untergeordnete Fensterhandles sowie Handles von Steuerelementen in Dialogfeldern. Eine Anwendung legt den Bezeichner für ein untergeordnetes Fenster fest, wenn sie das Fenster erstellt, indem sie dem hmenu-Parameter beim Aufrufen der CreateWindow - oder CreateWindowEx-Funktion den Bezeichnerwert zuweisen.

Obwohl GetDlgCtrlID einen Wert zurückgeben kann, wenn hwndCtl ein Handle für ein Fenster der obersten Ebene ist, können Fenster der obersten Ebene keine Bezeichner aufweisen, und ein solcher Rückgabewert ist nie gültig.

Beispiele

Ein Beispiel finden Sie unter Initialisieren eines Dialogfelds.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-dialogbox-l1-1-0 (in Windows 8 eingeführt)