GetClassWord 函数 (winuser.h)
将指定偏移量处的 16 位 (WORD) 值检索到指定窗口类所属的窗口类的额外类内存中。
注意 除 nIndex 设置为 GCW_ATOM 之外,已弃用此函数。 提供的函数仅用于与 16 位版本的 Windows 兼容。 应用程序应使用 GetClassLong 或 GetClassLongPtr 函数。
语法
WORD GetClassWord(
[in] HWND hWnd,
[in] int nIndex
);
参数
[in] hWnd
类型:HWND
窗口的句柄,以及窗口所属类的间接句柄。
[in] nIndex
类型: int
要检索的值的从零开始的字节偏移量。 有效值在零到类内存的字节数范围内,减去 2;例如,如果指定了 10 个或更多字节的额外类内存,则值 8 将是第五个 16 位整数的索引。 还有一个附加的有效值,如下表所示。
值 | 含义 |
---|---|
|
检索唯一标识窗口类的 ATOM 值。 这是 RegisterClass 或 RegisterClassEx 函数返回的同一个原子。 |
返回值
类型: WORD
如果函数成功,则返回值是请求的 16 位值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
通过在与 RegisterClass 函数一起使用的 WNDCLASS 结构的 cbClsExtra 成员中指定非零值来保留额外的类内存。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | winuser.h (包括 Windows.h) |
Library | User32.lib |
DLL | User32.dll |
API 集 | Windows 10版本 10.0.10 (240 中引入的 ext-ms-win-ntuser-windowclass-l1-1-2) |
请参阅
概念性
引用