Share via


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 值。 這是 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 版)

另請參閱

概念

GetClassLong

參考

RegisterClass

RegisterClassEx

SetClassWord

WNDCLASS

窗口類別