Compartir a través de

Función SHMapPIDLToSystemImageListIndex (shlobj_core.h)

  • Artículo

[SHMapPIDLToSystemImageListIndex está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Recupera el índice de icono de la lista de imágenes del sistema asociada a un elemento de carpeta.

Sintaxis

int SHMapPIDLToSystemImageListIndex(
  [in]            IShellFolder    *pshf,
  [in]            PCUITEMID_CHILD pidl,
  [out, optional] int             *piIndexSel
);

Parámetros

[in] pshf

Tipo: IShellFolder*

Puntero de interfaz IShellFolder para la carpeta que contiene el elemento.

[in] pidl

Tipo: PCUITEMID_CHILD

Puntero a la estructura ITEMIDLIST del elemento.

[out, optional] piIndexSel

Tipo: int*

Puntero a un valor int que, cuando esta función vuelve correctamente, recibe el índice del icono de apertura del elemento en la lista de imágenes del sistema. Si el elemento no tiene un icono de apertura especial, se devuelve el índice de su icono normal. Si el icono de apertura existe y no se puede obtener, el valor al que apunta piIndex se establece en -1. Este parámetro puede ser NULL si la aplicación que realiza la llamada no está interesada en el icono de apertura .

Valor devuelto

Tipo: int

Devuelve el índice del icono normal del elemento en la lista de imágenes del sistema si se ejecuta correctamente o -1 de lo contrario.

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
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)