Share via


LoadResource

This function loads the specified resource into global memory.

HGLOBAL LoadResource( 
HMODULE hModule, 
HRSRC hResInfo ); 

Parameters

  • hModule
    Handle to the module whose executable file contains the resource. If hModule is NULL, the system loads the resource from the module that was used to create the current process. In Windows CE versions 1.0 and 1.01, setting this parameter to NULL is not supported.
  • hResInfo
    Handle to the resource to be loaded. This handle must be created by using the FindResource function.

Return Values

A handle to the data associated with the resource indicates success. NULL indicates failure. To get extended error information, call GetLastError.

Remarks

The return type of LoadResource is HGLOBAL for backward compatibility, not because the function returns a handle to a global memory block.

When you are finished using a bitmap, cursor, icon, or menu, you can release its associated memory by calling one of the functions in the following table.

Resource Release function
Bitmap DeleteObject
Cursor DestroyCursor
Icon DestroyIcon
Menu DestroyMenu

The system automatically deletes these resources when the process that loaded them terminates, however, calling the appropriate function saves memory and decreases the size of the process's working set.

Accelerator tables are an exception. They remain in memory until the process terminates.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Winbase.h   Coredll.lib, Nk.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

DeleteObject, DestroyCursor, DestroyIcon, DestroyMenu, FindResource, GetLastError, LoadLibrary

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.