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.