getDlgCtrlID 函数 (winuser.h)

检索指定控件的标识符。

语法

int GetDlgCtrlID(
  [in] HWND hWnd
);

参数

[in] hWnd

类型:HWND

控件的句柄。

返回值

类型: int

如果函数成功,则返回值是控件的标识符。

如果函数失败,则返回值为零。 例如, hwndCtl 参数的值无效将导致函数失败。 要获得更多的错误信息,请调用 GetLastError。

注解

GetDlgCtrlID 接受对话框中的子窗口句柄和控件句柄。 应用程序通过在调用 CreateWindowCreateWindowEx 函数时将标识符值分配给 hmenu 参数来设置子窗口的标识符。

尽管如果 hwndCtl 是顶级窗口的句柄,GetDlgCtrlID 可能会返回值,但顶级窗口不能包含标识符,并且此类返回值永远有效。

示例

有关示例,请参阅 初始化对话框

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 windows 8 中引入的 ext-ms-win-ntuser-dialogbox-l1-1-0 ()

请参阅

概念性

CreateWindow

CreateWindowEx

对话框

GetDlgItem

引用