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 函式傳回的相同 Atom。 |
傳回值
類型: WORD
如果函式成功,則傳回值是要求的16位值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
在搭配 RegisterClass 函式使用的 WNDCLASS 結構之 cbClsExtra 成員中指定非零值,以保留額外的類別記憶體。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winuser.h (包括 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |
API 集合 | ext-ms-win-ntuser-windowclass-l1-1-2 (於 Windows 10 10.0.10240 版) |
另請參閱
概念
參考