The LockResource function locks the specified resource in memory.
LPVOID LockResource(
HGLOBAL hResData // handle to resource to lock
);
If the loaded resource is locked, the return value is a pointer to the first byte of the resource; otherwise, it is NULL.
Trying to lock a resource by using the handle returned by the FindResource or FindResourceEx function will not work. You will get back a value that is incorrect and points to random data.
When you are finished using an accelerator table, bitmap, cursor, icon, or menu, you can release its associated memory by calling one of the functions in the following table.
Resource | Release function |
---|---|
Accelerator table | DestroyAcceleratorTable |
Bitmap | DeleteObject |
Cursor | DestroyCursor |
Icon | DestroyIcon |
Menu | DestroyMenu |
The system automatically deletes these resources when the process that created them terminates, however, calling the appropriate function saves memory and decreases the size of the process's working set.
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Requires version 1.0 or later.
Header: Declared in winbase.h.
Import Library: Use kernel32.lib.
Resources Overview, Resource Functions, FindResource, FindResourceEx, LoadResource