Compartilhar via


Função LoadResource (libloaderapi.h)

Recupera um identificador que pode ser usado para obter um ponteiro para o primeiro byte do recurso especificado na memória.

Sintaxe

HGLOBAL LoadResource(
  [in, optional] HMODULE hModule,
  [in]           HRSRC   hResInfo
);

Parâmetros

[in, optional] hModule

Tipo: HMODULE

Um identificador para o módulo cujo arquivo executável contém o recurso. Se hModule for NULL, o sistema carregará o recurso do módulo que foi usado para criar o processo atual.

[in] hResInfo

Tipo: HRSRC

Um identificador para o recurso a ser carregado. Esse identificador é retornado pela função FindResource ou FindResourceEx .

Retornar valor

Tipo: HGLOBAL

Se a função for bem-sucedida, o valor retornado será um identificador para os dados associados ao recurso.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O tipo de retorno de 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 a função GlobalLock ou GlobalFree . Para obter um ponteiro para o primeiro byte dos dados de recurso, chame a função LockResource ; para obter o tamanho do recurso, chame SizeofResource.

GlobalSize retorna 0 para um HGLOBAL de recurso. Como resultado, todas as APIs que dependem do GlobalSize para determinar o tamanho do HGLOBAL não funcionarão corretamente. Por exemplo, use SHCreateMemStream em vez de CreateStreamOnHGlobal.

Para usar um recurso imediatamente, um aplicativo deve usar as seguintes funções específicas do recurso para localizar e carregar o recurso em uma chamada.

Função Ação Para remover o recurso
FormatMessage Carrega e formata uma entrada de tabela de mensagens Nenhuma ação necessária
LoadAccelerators Carrega uma tabela de aceleradores DestroyAcceleratorTable
Loadbitmap Carrega um recurso de bitmap DeleteObject
Loadcursor Carrega um recurso de cursor DestroyCursor
Loadicon Carrega um recurso de ícone Destroyicon
LoadMenu Carrega um recurso de menu Destroymenu
Loadstring Carrega um recurso de cadeia de caracteres Nenhuma ação necessária
 

Por exemplo, um aplicativo pode usar a função LoadIcon para carregar um ícone para exibição na tela, seguido por DestroyIcon quando concluído.

Exemplos

Para obter um exemplo, consulte Atualizando recursos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho libloaderapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Conceitual

Findresource

FindResourceEx

LoadLibrary

Loadmodule

LockResource

Outros recursos

Referência

Recursos