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