Función GetIconInfoExW (winuser.h)

Artículo
06/21/2023

Recupera información sobre el icono o cursor especificados. GetIconInfoEx extiende GetIconInfo mediante la estructura ICONINFOEX más reciente.

Sintaxis

BOOL GetIconInfoExW(
  [in]      HICON        hicon,
  [in, out] PICONINFOEXW 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.

[in, out] piconinfo

Tipo: PICONINFOEX

Cuando este método vuelve, contiene un puntero a una estructura ICONINFOEX . La función rellena los miembros de la estructura.

Valor devuelto

Tipo: BOOL

TRUE indica que se ha realizado correctamente; FALSE indica un error.

Observaciones

GetIconInfoEx crea mapas de bits para hbmMask y hbmColor o miembros de ICONINFOEX. 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.

Nota

El encabezado winuser.h define GetIconInfoEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos


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	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll