ExtractAssociatedIconExA 関数 (shellapi.h)
[ExtractAssociatedIconEx は、[要件] セクションで指定されたオペレーティング システムで使用できます。 それ以降のバージョンでは、変更または使用できない可能性があります。
リソースとしてファイルに格納されているアイコン、またはファイルに関連付けられている実行可能ファイルに格納されているアイコンへのハンドルを取得します。 これは、アイコンが実行可能ファイルから抽出されたときにアイコンの ID を取得することによって、ExtractAssociatedIcon 関数を拡張します。
構文
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
WORD 値へのポインター。入力時に、ハンドルを取得するアイコンの ID を指定します。
関数が戻るときに、アイコン ハンドルが実行可能ファイル (lpIconPath によって指す実行可能ファイルまたは関連する実行可能ファイル
戻り値
型: HICON
成功した場合はアイコンのハンドルを返し、それ以外の場合は NULL
備考
この関数によって返されるアイコン ハンドルは、不要になったとき DestroyIcon を呼び出すことによって解放する必要があります。
手記
shellapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして ExtractAssociatedIconEx を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | shellapi.h |
| ライブラリ | Shell32.lib |
| DLL | Shell32.dll (バージョン 5.0 以降) |
関連項目
ExtractAssociatedIcon の
ExtractIconEx を