GetClassWord

小甲鱼

注：本文档由 无符号整形 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

GetClassWord 函数用于获得有关指定窗口的信息，该信息是窗体类额外存储空间的 16 位整型值。

在窗口类的额外存储空间中的指定偏移地址获取指定窗口所属窗口类的 16 位值。

注意：该函数除了将 nIndex 参数设置为 GCW_ATOM 外，其它用途均不建议使用。这个函数仍然存在的原因是为了兼容 16 为的 Windows。现在的应用程序应该使用 GetClassLong 函数或 GetClassLongPtr 函数实现。


API 函数原型：

注释：_In_ 说明该参数是输入的。

WORD WINAPI GetClassWord(
  _In_ HWND hWnd,
  _In_ int  nIndex
);

参数解析：

参数	含义
hWnd	指向一个窗口的句柄，GetClassWord 函数会间接地获取该窗口所属的窗口类
nIndex	1. 指定要获取的基于 0 的偏移量。有效值的范围从 0 到窗口额外内存空间的字节数减去 2。例如，若指定了 10 位或多于 10 位的窗体类的额外存储空间，则应设为第 5 个 16 位整数的索引位 8（10 - 2 = 8）。 2. 下表所列值是额外允许的合法值： 值 含义 GCW_ATOM（-32） 检索窗口类的 ATOM 值。这与 RegisterClass 函数或 RegisterClassEx 函数返回的相同的ATOM值。

返回值：

1. 如果函数成功，返回值是所需的 16 位值。

2. 如果函数失败，返回值为零。

获取有关错误的更多信息，请调用 GetLastError 函数。


备注：

通过调用 RegisterClassEx 函数，将 WNDCLASSEX 结构中的 cbClsExtra 成员设为一个非 0 值来保留额外的类的储存空间。


需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Winuser.h (包含于 Windows.h)
Library	User32.lib
DLL	User32.dll
Unicode and ANSI names	GetWindowTextLengthW (Unicode) 和 GetWindowTextLengthA (ANSI)

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。