ExtractAssociatedIconExA 関数 (shellapi.h)

[ExtractAssociatedIconEx は、[要件] セクションで指定されたオペレーティング システムで使用できます。 これは、以降のバージョンで変更または使用できない可能性があります。

ファイル内のリソースとして格納されているアイコン、またはファイルに関連付けられている実行可能ファイルに格納されているアイコンへのハンドルを取得します。 ExtractAssociatedIcon 関数を拡張するには、そのアイコンが実行可能ファイルから抽出されるときにアイコンの ID を取得します。

構文

HICON ExtractAssociatedIconExA(
  [in]      HINSTANCE hInst,
  [in, out] LPSTR     pszIconPath,
  [in, out] WORD      *piIconIndex,
  [in, out] WORD      *piIconId
);

パラメーター

[in] hInst

種類: HINSTANCE

アイコンの抽出元となるモジュールのハンドル。

[in, out] pszIconPath

種類: LPTSTR

エントリ時に、アイコンを含むファイルの完全なパスとファイル名を指定する文字列へのポインター。 関数は、そのファイルまたはそのファイルに関連付けられている実行可能ファイルからアイコン ハンドルを抽出します。

この関数が戻るときに、アイコン ハンドルが実行可能ファイル (このパラメーターによって直接指される実行可能ファイルまたは関連する実行可能ファイル) から取得された場合、関数は、その実行可能ファイルの完全なパスとファイル名を、このパラメーターが指すバッファーに格納します。

[in, out] piIconIndex

型: LPWORD

エントリ時にハンドルを取得するアイコンのインデックスを指定する WORD 値へのポインター。

関数が戻るときに、アイコン ハンドルが実行可能ファイル ( lpIconPath が指す実行可能ファイルまたは関連する実行可能ファイル) から取得された場合、この値はそのファイル内のアイコンのインデックスを指します。

[in, out] piIconId

型: LPWORD

入力時にハンドルを取得するアイコンの ID を指定する WORD 値へのポインター。

関数が戻るときに、アイコン ハンドルが実行可能ファイル ( lpIconPath が指す実行可能ファイルまたは関連する実行可能ファイル) から取得された場合、この値はそのファイル内のアイコンの ID を指します。

戻り値

種類: HICON

成功した場合はアイコンのハンドルを返し、それ以外の場合は NULL を返します。

注釈

この関数によって返されるアイコン ハンドルは、必要なくなったときに DestroyIcon を呼び出して解放する必要があります。

注意

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

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shellapi.h
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 5.0 以降)

こちらもご覧ください

ExtractAssociatedIcon

ExtractIcon

ExtractIconEx