Compartir a través de


Función GetIconInfoExA (winuser.h)

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

Sintaxis

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

Comentarios

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

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

Consulte también

Conceptual

Mapas de bits

Iconos

DeleteObject

GetObject

BITMAP

CreateIcon

CreateIconFromResource

CreateIconIndirect

Destroyicon

DrawIcon

DrawIconEx

LoadIcon

LookupIconIdFromDirectory

ICONINFO