ExtractAssociatedIconExW

ExtractAssociatedIconEx は変更されたり利用できなくなったりする可能性がある。(Unicode)

ExtractAssociatedIconExW hInst, pszIconPath, piIconIndex, piIconId

hInst : [intptr] 型: HINSTANCE アイコンを抽出するモジュールのハンドル。
pszIconPath : [wstr] 型: LPTSTR 文字列へのポインタ。入力時にはアイコンを含むファイルの完全なパスとファイル名を指定する。関数はそのファイル、またはそのファイルに関連付けられた実行ファイルからアイコンハンドルを抽出する。
piIconIndex : [var] 型: LPWORD WORD 値へのポインタ。入力時にはハンドルを取得するアイコンのインデックスを指定する。
piIconId : [var] 型: LPWORD WORD 値へのポインタ。入力時にはハンドルを取得するアイコンの ID を指定する。

(プラグイン / モジュール : shell32.dll)

解説

ExtractAssociatedIconEx は変更されたり利用できなくなったりする可能性がある。(Unicode)

[戻り値]
型: HICON 成功した場合はアイコンへのハンドルを返す。それ以外の場合は NULL を返す。

[備考]
この関数が返したアイコンハンドルは、不要になった時点で DestroyIcon を呼び出して解放しなければならない。
> [!NOTE] > shellapi.h ヘッダは UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または
Unicode 版を自動的に選択するエイリアスとして ExtractAssociatedIconEx
を定義している。エンコーディング非依存のエイリアスとエンコーディング依存のコードを混在させるとミスマッチが生じ、コンパイルエラーや実行時エラーを引き起こす可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報