winuser.h

GetIconInfo

La función GetIconInfo recupera información sobre el icono o cursor especificado.

Sintaxis

BOOL GetIconInfo(
    HICON hIcon,         // manipulador de icono
    PICONINFO piconinfo  // dirección de estructura de icono
   );

Parámetros

hIcon: identifica el icono o cursor. Para recuperar información sobre un icono o cursor estándar, especificar uno de los siguientes valores:

Valor	Significado
IDC_ARROW	Cursor flecha.
IDC_IBEAM	Cursor I.
IDC_WAIT	Cursor de reloj de arena.
IDC_CROSS	Cursor en cruz.
IDC_UPARROW	Cursor de flecha arriba.
IDC_SIZENWSE	Cursor de tamaño, puntas al noroeste y sureste.
IDC_SIZENESW	Cursor de tamaño, puntas al noreste y sudoeste.
IDC_SIZEWE	Cursor de tamaño, puntas al este y oeste.
IDC_SIZENS	Cursor de tamaño, puntas al norte y sur.
IDC_SIZEALL	Cursor de tamaño, puntas al norte, sur, este y oeste.
IDC_NO	Cursor "No".
IDC_APPSTARTING	Cursor de comienzo de aplicación (flecha y reloj de arena).
IDC_HELP	Cursor de ayuda (flecha e interrogación).
IDI_APPLICATION	Icono de aplicación.
IDI_HAND	Icono de señal de Stop.
IDI_QUESTION	Icono de interrogación.
IDI_EXCLAMATION	Icono de exclamación.
IDI_ASTERISK	Icono de asterisco (letra "i" en un círculo).
IDI_WINLOGO	Icono de logo de Windows.

piconinfo: puntero a una estructura ICONINFO. La función rellena los miembros de esa estructura.

Valor de retorno

Si la función tiene éxito, el valor de retorno será distinto de cero y la función rellenará los miembros de la estructura ICONINFO especificada.

Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

GetIconInfo crea mapas de bits para los moembros hbmMask y hbmColor de ICONINFO. La aplicación que llama debe manejar esos mapas de bits y borrarlos cuando ya no sean necesarios.