Compartilhar via


Função LockResource (libloaderapi.h)

Recupera um ponteiro para o recurso especificado na memória.

Sintaxe

LPVOID LockResource(
  [in] HGLOBAL hResData
);

Parâmetros

[in] hResData

Tipo: HGLOBAL

Um identificador para o recurso a ser acessado. A função LoadResource retorna esse identificador. Observe que esse parâmetro é listado como uma variável HGLOBAL apenas para compatibilidade com versões anteriores. Não passe nenhum valor como um parâmetro diferente de um valor retornado bem-sucedido da função LoadResource .

Valor retornado

Tipo: LPVOID

Se o recurso carregado estiver disponível, o valor retornado será um ponteiro para o primeiro byte do recurso; caso contrário, ele é NULL.

Comentários

O ponteiro retornado por LockResource é válido até que o módulo que contém o recurso seja descarregado. Não é necessário desbloquear recursos porque o sistema os exclui automaticamente quando o processo que os criou é encerrado.

Não tente bloquear um recurso usando o identificador retornado pela função FindResourceA ou pela função FindResourceExA . Esse identificador aponta para dados aleatórios.

Observação

LockResource realmente não bloqueia a memória; ele é usado apenas para obter um ponteiro para a memória que contém os dados do recurso. O nome da função vem de versões anteriores ao Windows XP, quando ela foi usada para bloquear um bloco de memória global alocado pelo LoadResource.

Exemplos

Para obter um exemplo, consulte Atualizando recursos.

Requisitos

   
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

Referência