SHUpdateImageW-Funktion (shlobj_core.h)
Benachrichtigt die Shell, dass sich ein Image in der Systemimageliste geändert hat.
Syntax
void SHUpdateImageW(
[in] LPCWSTR 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
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für