SHDefExtractIconW

ファイルからアイコンを抽出するための既定のハンドラーを提供する。(Unicode)

SHDefExtractIconW pszIconFile, iIndex, uFlags, phiconLarge, phiconSmall, nIconSize

pszIconFile : [wstr] 型: LPCTSTR アイコンを抽出するファイルのパスと名前を含む、null 終端バッファーへのポインター。
iIndex : [int] 型: int pszIconFile で指定されたファイル内のアイコンの位置。正の数の場合は、ファイル内のアイコンの 0 から始まる位置を表す。たとえば 0 はリソースファイルの 1 番目のアイコンを、2 は 3 番目のアイコンを指す。負の数の場合は、アイコンのリソース ID を表す。
uFlags : [int] 型: UINT アイコンの抽出を制御するフラグ。
phiconLarge : [intptr] 型: HICON* この関数が成功した場合、nIconSize の下位ワードで指定された大きい方のアイコンのハンドルを受け取る HICON へのポインター。この値は NULL でもよい。
phiconSmall : [intptr] 型: HICON* この関数が成功した場合、nIconSize の上位ワードで指定された小さい方のアイコンのハンドルを受け取る HICON へのポインター。
nIconSize : [int] 型: UINT 下位ワードに大アイコンのサイズ、上位ワードに小アイコンのサイズを格納した値。サイズはピクセル単位で測定する。既定の大小サイズを指定するには 0 を渡す。

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

解説

ファイルからアイコンを抽出するための既定のハンドラーを提供する。(Unicode)

[戻り値]
型: HRESULT この関数は次のいずれかの値を返すことがある。
（以下省略）

[備考]
この関数で作成したアイコンリソースを不要になった時点で解放するのは呼び出し側の責任である。これは DestroyIcon 関数で行える。
> [!NOTE] > shlobj_core.h ヘッダーは SHDefExtractIcon を、UNICODE
プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode
版を自動的に選択するエイリアスとして定義している。エンコーディング中立なエイリアスとそうでないコードを混在して使用すると、コンパイルや実行時のエラーにつながる不一致が発生する場合がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報