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が指す文字列に実行可能ファイルの完全なパスとファイル名
関数が失敗した場合、戻り値は NULL
備考
不要になったら、呼び出し元は、DestroyIcon 関数を呼び出すことによって、ExtractAssociatedIcon によって返されるアイコン ハンドルを解放する必要があります。
手記
shellapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして ExtractAssociatedIcon を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | shellapi.h |
| DLL | Shell32.dll |
| API セットの | ext-ms-win-shell-shell32-l1-2-1 (Windows 10 バージョン 10.0.10240 で導入) |
関連項目
ExtractAssociatedIconEx の
ExtractIconEx を