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
更新されるアイコンのシステム イメージ リスト内のインデックスを指定する整数。
戻り値
なし
解説
更新するアイコンのシステム イメージ リストのインデックスがわからない場合は、 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 以降) |