共用方式為


GetClassLongA 函式 (winuser.h)

從與指定視窗相關聯的 WNDCLASSEX 結構,擷取指定的 32 位 (DWORD) 值。

注意 如果您要擷取指標或句柄,GetClassLongPtr 函式已取代此函式。 (指標和控點在32位 Windows 上為32位,在64位 Windows 上為64位。
 

語法

DWORD GetClassLongA(
  [in] HWND hWnd,
  [in] int  nIndex
);

參數

[in] hWnd

類型:HWND

視窗的句柄,而且間接地是窗口所屬的類別。

[in] nIndex

類型:int

要擷取的值。 若要從額外的類別記憶體中擷取值,請指定要擷取之值的正、以零起始的位元組位移。 有效值為零到額外類別記憶體的位元元組數目,減去四個;例如,如果您指定了12個以上的額外類別記憶體位元組,則值為8會是第三個整數的索引。 若要從 WNDCLASSEX 結構擷取任何其他值,請指定下列其中一個值。

價值 意義
GCW_ATOM
-32
擷取可唯一識別窗口類別 ATOM 值。 這是 RegisterClassEx 函式傳回的相同 Atom。
GCL_CBCLSEXTRA
-20
擷取與 類別相關聯之額外記憶體的大小,以位元組為單位。
GCL_CBWNDEXTRA
-18
擷取與 類別中每個視窗相關聯的額外視窗記憶體大小,以位元組為單位。 如需如何存取此記憶體的詳細資訊,請參閱 GetWindowLong
GCL_HBRBACKGROUND
-10
擷取與 類別相關聯的背景筆刷句柄。
GCL_HCURSOR
-12
擷取與 類別相關聯之數據指標的句柄。
GCL_HICON
-14
擷取與 類別相關聯之圖示的句柄。
GCL_HICONSM
-34
擷取與 類別相關聯之小型圖示的句柄。
GCL_HMODULE
-16
擷取註冊 類別之模組的句柄。
GCL_MENUNAME
-8
擷取功能表名稱字串的位址。 字串會識別與 類別相關聯的功能表資源。
GCL_STYLE
-26
擷取視窗類別樣式位。
GCL_WNDPROC
-24
擷取視窗程序的位址,或代表視窗程式位址的句柄。 您必須使用 CallWindowProc 函式來呼叫視窗程式。

傳回值

類型:DWORD

如果函式成功,傳回值就是要求的值。

如果函式失敗,傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

言論

在搭配 RegisterClassEx 函式使用的 WNDCLASSEX 結構中指定非零值,以保留額外的類別記憶體。

注意

winuser.h 標頭會將 GetClassLong 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winuser.h (包括 Windows.h)
連結庫 User32.lib
DLL User32.dll
API 集 ext-ms-win-ntuser-windowclass-l1-1-1 (在 Windows 8.1 中引進)

另請參閱

概念

GetClassLongPtr

GetWindowLong

參考

RegisterClassEx

SetClassLong

WNDCLASSEX

視窗類別