SHUpdateImageW

システムイメージリスト内のイメージが変更されたことをシェルに通知する。(Unicode)

SHUpdateImageW pszHashItem, iIndex, uFlags, iImageIndex

pszHashItem : [wstr] 型: LPCTSTR アイコンを含むファイルの完全修飾パスを指定する文字列値へのポインター。IExtractIcon::GetIconLocation の szIconFile パラメーターが指すバッファーで返されたパスを使用する。
iIndex : [int] 型: int pszHashItem で指定されたファイル内のアイコンのゼロから始まるインデックスを指定する整数。IExtractIcon::GetIconLocation の piIndex パラメーターが指す値を使用する。
uFlags : [int] 型: UINT アイコンの属性を決定するフラグを指定する符号なし整数。uFlags は IExtractIcon::GetIconLocation の pwFlags パラメーターが指す値に設定する。SHUpdateImage に関連するフラグは GIL_NOTFILENAME と GIL_SIMULATEDOC である。
iImageIndex : [int] 型: int 更新されるアイコンのシステムイメージリスト内のインデックスを指定する整数。

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

解説

システムイメージリスト内のイメージが変更されたことをシェルに通知する。(Unicode)

[備考]
更新したいアイコンのシステムイメージリスト内のインデックスがわからない場合は、uFlags パラメーターを
SHGFI_SYSICONINDEX に設定して SHGetFileInfo
を使用する。IExtractIcon::GetIconLocation
は、置き換えたい新しいアイコンではなく、更新が必要な古いアイコンのパラメーターで使用しなければならない。
> [!NOTE] > shlobj_core.h ヘッダーは SHUpdateImage を、UNICODE
プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode
版を自動的に選択するエイリアスとして定義している。エンコーディング中立なエイリアスとそうでないコードを混在して使用すると、コンパイルや実行時のエラーにつながる不一致が発生する場合がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報