Función GetIconInfo (winuser.h)

Artículo
03/04/2024

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)