The FindResource function determines the location of a resource with the specified type and name in the specified module.
HRSRC FindResource(
HMODULE hModule, |
// resource-module handle |
LPCTSTR lpName, |
// pointer to resource name |
LPCTSTR lpType |
// pointer to resource type |
); |
A value of NULL specifies the module handle associated with the image file
that the operating system used to create the current process.
Value |
Meaning |
RT_ACCELERATOR |
Accelerator table |
RT_ANICURSOR |
Animated cursor |
RT_ANIICON |
Animated icon |
RT_BITMAP |
Bitmap resource |
RT_CURSOR |
Hardware-dependent cursor resource |
RT_DIALOG |
Dialog box |
RT_FONT |
Font resource |
RT_FONTDIR |
Font directory resource |
RT_GROUP_CURSOR |
Hardware-independent cursor resource |
RT_GROUP_ICON |
Hardware-independent icon resource |
RT_ICON |
Hardware-dependent icon resource |
RT_MENU |
Menu resource |
RT_MESSAGETABLE |
Message-table entry |
RT_RCDATA |
Application-defined resource (raw data) |
RT_STRING |
String-table entry |
RT_VERSION |
Version resource |
If the function succeeds, the return value is a handle to the specified resource’s info block. To obtain a handle to the resource, pass this handle to the LoadResource function.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.
If the high-order word of the lpName or lpType parameter is zero, the low-order word specifies the integer identifier of the name or type of the given resource. Otherwise, those parameters are long pointers to null-terminated strings. If the first character of the string is a pound sign (#), the remaining characters represent a decimal number that specifies the integer identifier of the resource’s name or type. For example, the string “#258” represents the integer identifier 258.
An application should reduce the amount of memory required for the resources by referring to them by integer identifier instead of by name.
An application can use FindResource to find any type of resource, but this function should be used only if the application must access the binary resource data when making subsequent calls to LoadLibrary and LockResource.
To use a resource immediately, an application should use one of the following resource-specific functions to find and load the resources in one call:
Function |
Action |
Loads and formats a message-table entry. | |
Loads an accelerator table. | |
Loads a bitmap resource. | |
Loads a cursor resource. | |
Loads an icon resource. | |
Loads a menu resource. | |
Loads a string-table entry. |
For example, an application can use the LoadIcon function to load an icon for display on the screen. However, the application should use FindResource and LoadResource if it is loading the icon to copy its data to another application.
FindResourceEx, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource
file: /Techref/os/win/api/win32/func/src/f24_17.htm, 9KB, , updated: 2001/8/14 15:27, local time: 2024/8/17 07:35,
18.116.62.27:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://techref.massmind.org/techref/os/win/api/win32/func/src/f24_17.htm"> FindResource</A> |
Did you find what you needed? |
Welcome to massmind.org! |
Welcome to techref.massmind.org! |
.