Compartir a través de


función Shell_GetCachedImageIndexW (shlobj_core.h)

[Shell_GetCachedImageIndex está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores. 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 en pwszIconPath.

uIconFlags

Tipo: UINT

No se usa.

Valor devuelto

Tipo: int

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

Observaciones

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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de shlobj_core.h (incluya Shlobj.h, Shlobj_core.h, Shlobj.h, Shlobj_core.h)
biblioteca de Shell32.lib
DLL de Shell32.dll (versión 5.0 o posterior)
conjunto de API de ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240)

Consulte también

fileIconInit