SHUpdateImageA 関数 (shlobj_core.h)

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

構文

void SHUpdateImageA(
  [in] LPCSTR pszHashItem,
  [in] int    iIndex,
  [in] UINT   uFlags,
  [in] int    iImageIndex
);

パラメーター

[in] pszHashItem

型: LPCTSTR

アイコンを含むファイルの完全修飾パスを指定する文字列値へのポインター。 IExtractIcon::GetIconLocationの szIconFile パラメーターによって指されるバッファーで返されるパス 使用します。

[in] iIndex

型: int

pszHashItemで指定されたファイル内のアイコンの 0 から始まるインデックスを指定する整数 。 IExtractIcon::GetIconLocationの piIndex パラメーターが指す値 使用します。

[in] uFlags

型: UINT

アイコン属性を決定するフラグを指定する符号なし整数。 uFlags IExtractIcon::GetIconLocationの pwFlags パラメーターが指す値 設定します。 SHUpdateImage に関連するフラグは、GIL_NOTFILENAME され、GIL_SIMULATEDOCされます。

[in] iImageIndex

型: int

更新されるアイコンのシステム イメージ リスト内のインデックスを指定する整数。

戻り値

何一つ

備考

更新するアイコンのシステム イメージ リストのインデックスがわからない場合は、uFlags パラメーターを SHGFI_SYSICONINDEXに設定 SHGetFileInfo を使用します。

IExtractIcon::GetIconLocation 、置き換える新しいアイコンではなく、更新する必要がある古いアイコンのパラメーターを使用する必要があります。

手記

shlobj_core.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SHUpdateImage を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	shlobj_core.h (Shlobj.h、Shlobj_core.h を含む)
ライブラリ	Shell32.lib
DLL	Shell32.dll (バージョン 4.7 以降)

関連項目

SHChangeNotify を する