Compartir a través de

Función SHGetStockIconInfo (shellapi.h)

  • Artículo

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

Sintaxis

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 de SHGSI_ICON haciendo que la función agregue la superposición de 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 de SHGSI_ICON haciendo que la función recupere la versión pequeña del icono, tal como se especifica en el SM_CXSMICON y SM_CYSMICON métricas del sistema.

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 esta función devuelve , contiene un puntero a una estructura SHSTOCKICONINFO que contiene la información solicitada.

Valor devuelto

Tipo: HRESULT

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

Comentarios

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

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shellapi.h
Archivo DLL Shell32.dll
Conjunto de API ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240)