winuser.h


CreateIconFromResource

La función CreateIconFromResource crea un icono o un cursor a partir de un recurso que describe el icono.

Sintaxis

HICON CreateIconFromResource(
    PBYTE presbits,   // puntero a bits del icono o cursor
    DWORD dwResSize,  // número de bytes en el buffer de bits
    BOOL fIcon,       // bandera de icono o cursor
    DWORD dwVer       // versión de formato de Windows
   );

Parámetros

presbits: puntero a buffer que contiene los bits de recurso del icono o cursor. Estos bits se obtienen normalmente por llamadas a las funciones LookupIconIdFromDirectory (en Windows 95 se puede usar también LookupIconIdFromDirectoryEx) y LoadResource.

dwResSize: especifica el tamaño, en bytes, de el conjunto de bits apuntados por el parámetro presbits.

fIcon: especifica si se trata de crear un icono o un cursor. Si este parámetro es TRUE, se creará un icono. Si es FALSE, se crerá un cursor.

dwVer: especifica el número de versión del formato de icono o cursor para los bits de recurso apuntados por el parámetro presbits. Este parámetro puede tomar uno de los siguientes valores:

Formato dwVer
Windows 2.x 0x00020000
Windows 3.x 0x00030000

Todas las aplicaciones basadas en Win32 usan el formato Windows 3.x para iconos y cursores.

Valor de retorno

Si la función tiene éxito, el valor de retorno será un manipulador al icono o cursor.

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

Observaciones

Las funciones CreateIconFromResource, CreateIconIndirect, GetIconInfo y {fLookupIconIdFromDirectory} (y en Windows 95 CreateIconFromResourceEx y LookupIconIdFromDirectoryEx) permiten a aplicaciones shell y a navegadores de iconos examinar y usar recursos de todo el sistema.