SHUpdateImageA-Funktion (shlobj_core.h)

  • Artikel

Benachrichtigt die Shell, dass sich ein Image in der Systemimageliste geändert hat.

Syntax

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

Parameter

[in] pszHashItem

Typ: LPCTSTR

Ein Zeiger auf einen Zeichenfolgenwert, der den vollqualifizierten Pfad der Datei angibt, die das Symbol enthält. Verwenden Sie den Pfad, der im Puffer zurückgegeben wird, auf den der szIconFile-Parameter von IExtractIcon::GetIconLocation verweist.

[in] iIndex

Typ: int

Eine ganze Zahl, die den nullbasierten Index des Symbols in der durch pszHashItem angegebenen Datei angibt. Verwenden Sie den Wert, auf den der piIndex-Parameter von IExtractIcon::GetIconLocation verweist.

[in] uFlags

Typ: UINT

Eine ganze Zahl ohne Vorzeichen, die die Flags angibt, die die Symbolattribute bestimmen. Legen Sie uFlags auf den Wert fest, auf den der pwFlags-Parameter von IExtractIcon::GetIconLocation verweist. Die für SHUpdateImage relevanten Flags sind GIL_NOTFILENAME und GIL_SIMULATEDOC.

[in] iImageIndex

Typ: int

Eine ganze Zahl, die den Index in der Systembildliste des zu aktualisierenden Symbols angibt.

Rückgabewert

Keine

Bemerkungen

Wenn Sie den Index in der Systembildliste des Zu aktualisierenden Symbols nicht kennen, verwenden Sie SHGetFileInfo , wobei der uFlags-Parameter auf SHGFI_SYSICONINDEX festgelegt ist.

Sie müssen IExtractIcon::GetIconLocation mit den Parametern des alten Symbols verwenden, das aktualisiert werden muss, nicht mit denen des neuen Symbols, durch das Sie es ersetzen möchten.

Hinweis

Der shlobj_core.h-Header definiert SHUpdateImage als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (einschließlich Shlobj.h, Shlobj_core.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 4.7 oder höher)

Weitere Informationen

SHChangeNotify