función Shell_GetCachedImageIndexW (shlobj_core.h)

  • Artículo

[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_GetCachedImageIndexW(
  LPCWSTR pszIconPath,
  int     iIconIndex,
  UINT    uIconFlags
);

Parámetros

pszIconPath

TBD

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.

Nota:

El encabezado shlobj_core.h define Shell_GetCachedImageIndex como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
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