GetClassInfoExA 函式 (winuser.h)
擷取視窗類別的相關信息,包括與視窗類別相關聯的小型圖示句柄。 GetClassInfo 函式不會擷取小型圖示的句柄。
語法
BOOL GetClassInfoExA(
[in, optional] HINSTANCE hInstance,
[in] LPCSTR lpszClass,
[out] LPWNDCLASSEXA lpwcx
);
參數
[in, optional] hInstance
類型: HINSTANCE
建立類別之應用程式的實例句柄。 若要擷取系統所定義類別的相關信息 (,例如按鈕或清單框) ,請將此參數設定為 NULL。
[in] lpszClass
類型: LPCTSTR
類別名稱。 名稱必須是預先註冊類別或先前呼叫 RegisterClass 或 RegisterClassEx 函式所註冊的類別。 或者,此參數可以是先前呼叫 RegisterClass 或 RegisterClassEx 所建立的類別 Atom。 Atom 必須以低序的 lpszClass 字組表示;高序字必須是零。
[out] lpwcx
類型: LPWNDCLASSEX
接收類別相關信息的 WNDCLASSEX 結構的指標。
傳回值
類型: BOOL
如果函式找到相符的類別並成功複製數據,則傳回值為非零。
如果函式找不到相符的類別並成功複製數據,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
類別 Atom 是使用 RegisterClass 或 RegisterClassEx 函式所建立,而不是 GlobalAddAtom 函式。
注意
winuser.h 標頭會將 GetClassInfoEx 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winuser.h (包括 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |
API 集合 | ext-ms-win-ntuser-windowclass-l1-1-0 (於 Windows 8) |
另請參閱
概念
參考