ExtractAssociatedIconA 関数 (shellapi.h)
ファイル内のリソースとして格納されているアイコン、またはファイルに関連付けられている実行可能ファイルに格納されているアイコンへのハンドルを取得します。
構文
HICON ExtractAssociatedIconA(
[in] HINSTANCE hInst,
[in, out] LPSTR pszIconPath,
[in, out] WORD *piIcon
);
パラメーター
[in] hInst
種類: HINSTANCE
呼び出し元アプリケーションのインスタンスへのハンドル。
[in, out] pszIconPath
種類: LPTSTR
エントリ時に、アイコンを含むファイルの完全なパスとファイル名を指定する文字列へのポインター。 この関数は、そのファイルまたはそのファイルに関連付けられている実行可能ファイルからアイコン ハンドルを抽出します。
この関数が戻るとき、アイコン ハンドルが実行可能ファイル ( lpIconPath によって指されている実行可能ファイルまたは関連する実行可能ファイル) から取得された場合、関数は、その実行可能ファイルの完全なパスとファイル名を、このパラメーターが指すバッファーに格納します。
[in, out] piIcon
型: LPWORD
入力時に、ハンドルが取得されるアイコンのインデックスを指定する WORD 値へのポインター。
関数が戻るとき、アイコン ハンドルが実行可能ファイル ( lpIconPath が指す実行可能ファイルまたは関連付けられた実行可能ファイル) から取得された場合、この値はそのファイル内のアイコンのインデックスを指します。
戻り値
種類: HICON
関数が成功した場合、戻り値はアイコン ハンドルです。 関連付けられた実行可能ファイルからアイコンが抽出された場合、関数は lpIconPath が指す文字列に実行可能ファイルの完全なパスとファイル名を格納し、アイコンの識別子を lpiIcon が指す WORD に格納します。
関数が失敗した場合は、返される値は NULL です。
注釈
不要になった場合、呼び出し元は DestroyIcon 関数を呼び出して ExtractAssociatedIcon によって返されるアイコン ハンドルを解放する必要があります。
ExtractAssociatedIcon 関数は、lpIconPath で指定されたファイル内のインデックス付きアイコンを最初に検索します。 関数がそのファイルからアイコン ハンドルを取得できず、ファイルに実行可能ファイルが関連付けられている場合、その実行可能ファイルでアイコンが検索されます。 実行可能ファイルとの関連付けは、ファイル名拡張子に基づいており、レジストリのユーザーごとの部分に格納されます。
注意
shellapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして ExtractAssociatedIcon を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shellapi.h |
| [DLL] | Shell32.dll |
| API セット | ext-ms-win-shell-shell32-l1-2-1 (Windows 10 バージョン 10.0.10240 で導入) |