Shell_GetCachedImageIndexW-Funktion (shlobj_core.h)
[Shell_GetCachedImageIndex steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen Shell_GetCachedImageIndexA oder Shell_GetCachedImageIndexW.]
Ruft den Cacheindex eines zwischengespeicherten Symbols ab.
Syntax
int Shell_GetCachedImageIndexW(
LPCWSTR pszIconPath,
int iIconIndex,
UINT uIconFlags
);
Parameter
pszIconPath
TBD
iIconIndex
Typ: int
Der Index des Bilds in der Datei mit dem Namen pwszIconPath.
uIconFlags
Typ: UINT-
Wird nicht verwendet.
Rückgabewert
Typ: int
Gibt den Index des Bilds oder –1 bei Einem Fehler zurück.
Bemerkungen
Die versionen Shell_GetCachedImageIndexA und Shell_GetCachedImageIndexW dieser Funktion wurden in Windows Vista hinzugefügt. Rufen Sie für Unicode-Zeichenfolgen entweder Shell_GetCachedImageIndexW oder Shell_GetCachedImageIndexauf. Für ANSI-Zeichenfolgen müssen Sie Shell_GetCachedImageIndexA explizit aufrufen.
Windows Server 2003 und Windows XP: Nur Shell_GetCachedImageIndex wird unterstützt. Shell_GetCachedImageIndex erfordert eine Unicode-Zeichenfolge.
Anmerkung
Der header shlobj_core.h definiert Shell_GetCachedImageIndex 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 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, Shlobj.h, Shlobj_core.h) |
| Library | Shell32.lib |
| DLL- | Shell32.dll (Version 5.0 oder höher) |
| API-Satz | ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240) |