Compartir a través de


Función GetIconInfo (winuser.h)

Recupera información sobre el icono o cursor especificados.

Sintaxis

BOOL GetIconInfo(
  [in]  HICON     hIcon,
  [out] PICONINFO piconinfo
);

Parámetros

[in] hIcon

Tipo: HICON

Identificador del icono o cursor.

Para recuperar información sobre un icono o cursor estándar, especifique el identificador que comienza con el prefijo IDI_ o el identificador que comienza con el prefijo IDC_ en este parámetro.

[out] piconinfo

Tipo: PICONINFO

Puntero a una estructura ICONINFO . La función rellena los miembros de la estructura.

Valor devuelto

Tipo: BOOL

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero y la función rellena los miembros de la estructura ICONINFO especificada.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

GetIconInfo crea mapas de bits para hbmMask y hbmColor o miembros de ICONINFO. La aplicación que realiza la llamada debe administrar estos mapas de bits y eliminarlos con la llamada DeleteObject cuando ya no sean necesarios.

Virtualización de PPP

Esta API no participa en la virtualización de PPP. La salida devuelta no se ve afectada por el ppp del subproceso que realiza la llamada.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-gui-l1-1-0 (introducido en Windows 8)

Consulte también

Conceptual

Mapas de bits

Iconos

DeleteObject

GetObject

BITMAP

CreateIcon

CreateIconFromResource

CreateIconIndirect

Destroyicon

DrawIcon

DrawIconEx

LoadIcon

LookupIconIdFromDirectory

ICONINFO