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 は lpszClass の下位ワードに含まれている必要があります。上位ワードは 0 である必要があります。

[out] lpwcx

種類: LPWNDCLASSEX

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

戻り値

種類: BOOL

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

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

解説

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

注意

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

要件

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

関連項目

概念

GetClassLong

GetClassName

リファレンス

RegisterClass

RegisterClassEx

ウィンドウ クラス