SHUpdateImageW 関数 (shlobj_core.h)

  • [アーティクル]

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

構文

void SHUpdateImageW(
  [in] LPCWSTR 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

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

戻り値

なし

解説

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

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

注意

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

要件

   
サポートされている最小のクライアント Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー shlobj_core.h (Shlobj.h、Shlobj_core.h を含む)
Library Shell32.lib
[DLL] Shell32.dll (バージョン 4.7 以降)

関連項目

SHChangeNotify