Shell_GetCachedImageIndex-Funktion (shlobj_core.h)

  • Artikel

[Shell_GetCachedImageIndex für die Verwendung in den Betriebssystemen verfügbar ist, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen Shell_GetCachedImageIndexA oder Shell_GetCachedImageIndexW.]

Ruft den Cacheindex eines zwischengespeicherten Symbols ab.

Syntax

int Shell_GetCachedImageIndex(
  [in] PCWSTR pwszIconPath,
       int    iIconIndex,
       UINT   uIconFlags
);

Parameter

[in] pwszIconPath

Typ: PCWSTR

Ein Zeiger auf einen Puffer, der den Pfad zur Bilddatei enthält.

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.

Hinweise

Die Shell_GetCachedImageIndexA und Shell_GetCachedImageIndexW Versionen dieser Funktion wurden in Windows Vista hinzugefügt. Rufen Sie für Unicode-Zeichenfolgen entweder Shell_GetCachedImageIndexW oder Shell_GetCachedImageIndex auf. 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.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) 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, Shlobj.h, Shlobj_core.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)
APIs ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

FileIconInit