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 |