SHUpdateImageA-Funktion (shlobj_core.h)

Artikel
11/20/2024

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::GetIconLocationverweist.

[in] iIndex

Typ: int

Eine ganze Zahl, die den nullbasierten Index des Symbols in der datei angibt, die durch pszHashItemangegeben wird. Verwenden Sie den Wert, auf den der piIndex Parameter von IExtractIcon::GetIconLocationverweist.

[in] uFlags

Typ: UINT-

Eine nicht signierte ganze Zahl, die die Flags angibt, die die Symbolattribute bestimmen. Legen Sie uFlags- auf den Wert fest, auf den der pwFlags Parameter von IExtractIcon::GetIconLocationverweist. Die Kennzeichnungen, die für SHUpdateImage- relevant sind, sind GIL_NOTFILENAME und GIL_SIMULATEDOC.

[in] iImageIndex

Typ: int

Eine ganze Zahl, die den Index in der Systembildliste des Symbols angibt, das aktualisiert wird.

Rückgabewert

Nichts

Bemerkungen

Wenn Sie den Index in der Systembildliste des Zu aktualisierenden Symbols nicht kennen, verwenden Sie SHGetFileInfo-, wobei der parameter uFlags auf SHGFI_SYSICONINDEXfestgelegt 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.

Anmerkung

Der header shlobj_core.h 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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlobj_core.h (einschließlich Shlobj.h, Shlobj_core.h)
Library	Shell32.lib
DLL-	Shell32.dll (Version 4.7 oder höher)

Siehe auch

SHChangeNotify

Freigeben über