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できます。 このアトムは、lpszClassの下位ワードに含まれている必要があります。高次ワードはゼロでなければなりません。

[out] lpwcx

型: LPWNDCLASSEX

クラスに関する情報を受け取る WNDCLASSEX 構造体へのポインター。

戻り値

型: BOOL

関数が一致するクラスを検索し、データを正常にコピーした場合、戻り値は 0 以外です。

関数が一致するクラスを見つけず、データを正常にコピーした場合、戻り値は 0 になります。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

クラス アトムは、GlobalAddAtom 関数ではなく、RegisterClass または RegisterClassEx 関数 使用して作成されます。

手記

winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetClassInfoEx を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	winuser.h (Windows.h を含む)
ライブラリ	User32.lib
DLL	User32.dll
API セットの	ext-ms-win-ntuser-windowclass-l1-1-0 (Windows 8 で導入)

関連項目

概念

GetClassLong の

GetClassName を する

リファレンス

RegisterClass の

RegisterClassEx の

ウィンドウ クラス