CreateIconFromResource  D1604G 

The CreateIconFromResource function creates an icon or cursor from resource bits describing the icon.

HICON CreateIconFromResource(

    PBYTE presbits,

// pointer to icon or cursor bits

    DWORD dwResSize,

// number of bytes in bit buffer

    BOOL fIcon,

// icon or cursor flag

    DWORD dwVer

// Windows format version

   );

 

 

Parameters

presbits

Points to a buffer containing the icon or cursor resource bits. These bits are typically loaded by calls to the LookupIconIdFromDirectory1_OJ0_X (in Windows 95 you can also call LookupIconIdFromDirectoryEx) and LoadResource.W6P7M functions.

dwResSize

Specifies the size, in bytes, of the set of bits pointed to by the presbits parameter.

fIcon

Specifies whether an icon or a cursor is to be created. If this parameter is TRUE, an icon is to be created. If it is FALSE, a cursor is to be created.

dwVer

Specifies the version number of the icon or cursor format for the resource bits pointed to by the presbits parameter. This parameter can be one of the following values:

Format

dwVer

Windows 2.x

0x00020000

Windows 3.x

0x00030000

 

All Microsoft Win32-based applications use the Windows 3.x format for icons and cursors.

 

Return Values

If the function succeeds, the return value is the handle to the icon or cursor.

If the function fails, the return value is NULL. To get extended error information, call GetLastError11C2VS7.

Remarks

The CreateIconFromResource, CreateIconIndirect, GetIconInfo, and LookupIconIdFromDirectory functions (and in Windows 95 the CreateIconFromResourceEx and LookupIconIdFromDirectoryEx functions) allow shell applications and icon browsers to examine and use resources from throughout the system.

See Also

CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx