LoadResource

O LoadResource função carrega o recurso especificado para a memória global.

 (HGLOBAL LoadResource HMODULE  hModule, / / módulo de recurso identificadorHRSRChResInfo / / recurso identificador);
 

Parâmetros

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.
hResInfo
Identificador para o recurso a ser carregado. Esse identificador deve ser criado usando a função FindResource ou FindResourceEx.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é um identificador para os dados associados com o recurso.

Se a função falhar, o valor de retorno é NULL. Para informações de erro estendidas get, chamar GetLastError.

Observações

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 de memória global. Não passe esse identificador para o GlobalLock ou GlobalFree função. Para obter um ponteiro para os dados de recurso, chamar a função LockResource.

Quando você tiver terminado usando uma tabela de teclas aceleradoras, bitmap, cursor, ícone ou menu, você pode liberar seu associado memória por chamado um das funções na tabela a seguir.

Recurso Função de lançamento
Tabela de teclas aceleradoras DestroyAcceleratorTable
Bitmap ExcluirObjeto
Cursor DestroyCursor
Ícone DestroyIcon
Menu DestroyMenu

O sistema exclui automaticamente esses recursos quando termina o processo que criado-los, no entanto, chamado de apropriado função salva memória e diminui o tamanho do conjunto de trabalho do processo.

Windows CE: O hModule parâmetro deve ser não-NULL.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinBase. h.
Biblioteca de importação:Use Kernel32. lib.

Ver também

Visão geral sobre recursos, recurso funciona, FindResource, FindResourceEx, LoadLibrary, LoadModule, LockResource