LoadResource
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Essa função retorna um identificador para um recurso especificado localizado em um dynamic-link library (DLL) ou executável.
Syntax
HGLOBAL LoadResource(
HMODULE hModule,
HRSRC hResInfo
);
Parameters
- hModule
Identificador para o módulo cujo arquivo executável contém o recurso. Se hModule é NULL, o sistema carrega o recurso do módulo que foi usado para criar o atual processo. Windows CE 1.0 e 1.01, configuração esse parâmetro para NULL não é com suporte.
- hResInfo
Identificador para o recurso a ser carregado. Esse identificador deve ser criado usando o FindResource função.
Return Value
Um identificador para os dados associado com o recurso indica sucesso. NULL Indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
O tipo de retorno do LoadResource é HGLOBAL Para compatibilidade com versões anteriores, não porque a função retorna um identificador para um bloco memória global. Sempre usar LockResource Para converter o identificador retornado por LoadResource Em um ponteiro.
Os recursos em um aplicativo, se de um arquivo executável ou um DLL, são sempre mapeados para o espaço de endereço de um processo. LoadResource Simplesmente recupera o endereço do recurso que já esteja na memória. LoadResource não aloca qualquer memória adicional. O ponteiro retornado por LockResource Identifica o endereço do bloco de memória, no arquivo executável ou no DLL, que contém o recurso especificado. O sistema automaticamente exclui esses recursos quando termina o processo que carregado-los, ou quando FreeLibrary é usado para descarregar um DLL que foi carregado com LoadLibrary.
Requirements
| Header | winbase.h |
| Library | coredll.lib, Nk.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |