Función Shell_GetCachedImageIndex (shlobj_core.h)

[Shell_GetCachedImageIndex está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use Shell_GetCachedImageIndexA o Shell_GetCachedImageIndexW.]

Recupera el índice de caché de un icono almacenado en caché.

Sintaxis

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

Parámetros

[in] pwszIconPath

Tipo: PCWSTR

Puntero a un búfer que contiene la ruta de acceso al archivo de imagen.

iIconIndex

Tipo: int

Índice de la imagen dentro del archivo denominado pwszIconPath.

uIconFlags

Tipo: UINT

No se usa.

Valor devuelto

Tipo: int

Devuelve el índice de la imagen o –1 en caso de error.

Comentarios

Las versiones Shell_GetCachedImageIndexA y Shell_GetCachedImageIndexW de esta función se agregaron en Windows Vista. Para las cadenas Unicode, llame a Shell_GetCachedImageIndexW o Shell_GetCachedImageIndex. Para las cadenas ANSI, debe llamar a Shell_GetCachedImageIndexA explícitamente.

Windows Server 2003 y Windows XP: Solo se admite Shell_GetCachedImageIndex . Shell_GetCachedImageIndex requiere una cadena Unicode.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h, Shlobj_core.h, Shlobj.h, Shlobj_core.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)
Conjunto de API ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240)

Consulte también

FileIconInit