Función SHGetStockIconInfo (shellapi.h)

Recupera información sobre los iconos de Shell definidos por el sistema.

Syntax

SHSTDAPI SHGetStockIconInfo(
            SHSTOCKICONID   siid,
            UINT            uFlags,
  [in, out] SHSTOCKICONINFO *psii
);

Parámetros

siid

Tipo: SHSTOCKICONID

Uno de los valores de la enumeración SHSTOCKICONID que especifica qué icono se debe recuperar.

uFlags

Tipo: UINT

Combinación de cero o más de las marcas siguientes que especifican qué información se solicita.

SHGSI_ICONLOCATION

Los miembros szPath e iIcon de la estructura SHSTOCKICONINFO reciben la ruta de acceso y el índice de icono del icono solicitado, en un formato adecuado para pasar a la función ExtractIcon . El valor numérico de esta marca es cero, por lo que siempre obtendrá la ubicación del icono independientemente de otras marcas.

SHGSI_ICON

El miembro hIcon de la estructura SHSTOCKICONINFO recibe un identificador para el icono especificado.

SHGSI_SYSICONINDEX

El miembro iSysImageImage de la estructura SHSTOCKICONINFO recibe el índice del icono especificado en la lista de imágenes del sistema.

SHGSI_LINKOVERLAY

Modifica el valor SHGSI_ICON haciendo que la función agregue la superposición del vínculo al icono del archivo.

SHGSI_SELECTED

Modifica el valor de SHGSI_ICON haciendo que la función combine el icono con el color de resaltado del sistema.

SHGSI_LARGEICON

Modifica el valor de SHGSI_ICON haciendo que la función recupere la versión grande del icono, tal como se especifica en las métricas del sistema de SM_CXICON y SM_CYICON.

SHGSI_SMALLICON

Modifica el valor SHGSI_ICON haciendo que la función recupere la versión pequeña del icono, tal como se especifica en las métricas del sistema SM_CXSMICON y SM_CYSMICON.

SHGSI_SHELLICONSIZE

Modifica los valores de SHGSI_LARGEICON o SHGSI_SMALLICON haciendo que la función recupere los iconos de tamaño de Shell en lugar de los tamaños especificados por las métricas del sistema.

[in, out] psii

Tipo: SHSTOCKICONINFO*

Puntero a una estructura SHSTOCKICONINFO . Cuando se llama a esta función, el miembro cbSize de esta estructura debe establecerse en el tamaño de la estructura SHSTOCKICONINFO . Cuando se devuelve esta función, contiene un puntero a una estructura SHSTOCKICONINFO que contiene la información solicitada.

Valor devuelto

Tipo: HRESULT

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Observaciones

Si esta función devuelve un identificador de icono en el miembro hIcon de la estructura SHSTOCKICONINFO a la que apunta psii, usted es responsable de liberar el icono con DestroyIcon cuando ya no lo necesite.

Requisitos

Requirement	Importancia
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo admitido	Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
Header	shellapi.h
Library	OneCore.Lib
DLL de	Shell32.dll
Conjunto de API	ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240)