GetClassWord 函数 (winuser.h)

将指定偏移量处的 16 位 (WORD) 值检索到指定窗口类所属的窗口类的额外类内存中。

注意nIndex 设置为 GCW_ATOM 之外,已弃用此函数。 提供的函数仅用于与 16 位版本的 Windows 兼容。 应用程序应使用 GetClassLongGetClassLongPtr 函数。
 

语法

WORD GetClassWord(
  [in] HWND hWnd,
  [in] int  nIndex
);

参数

[in] hWnd

类型:HWND

窗口的句柄,以及窗口所属类的间接句柄。

[in] nIndex

类型: int

要检索的值的从零开始的字节偏移量。 有效值在零到类内存的字节数范围内,减去 2;例如,如果指定了 10 个或更多字节的额外类内存,则值 8 将是第五个 16 位整数的索引。 还有一个附加的有效值,如下表所示。

含义
GCW_ATOM
-32
检索唯一标识窗口类的 ATOM 值。 这是 RegisterClassRegisterClassEx 函数返回的同一个原子。

返回值

类型: 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)

请参阅

概念性

GetClassLong

引用

RegisterClass

RegisterClassEx

SetClassWord

WNDCLASS

窗口类