Função VirtualUnlock (memoryapi.h)

  • Artigo

Desbloqueia um intervalo especificado de páginas no espaço de endereço virtual de um processo, permitindo que o sistema troque as páginas para o arquivo de paginação, se necessário.

Sintaxe

BOOL VirtualUnlock(
  [in] LPVOID lpAddress,
  [in] SIZE_T dwSize
);

Parâmetros

[in] lpAddress

Um ponteiro para o endereço base da região de páginas a ser desbloqueada.

[in] dwSize

O tamanho da região que está sendo desbloqueada, em bytes. A região das páginas afetadas inclui todas as páginas que contêm um ou mais bytes no intervalo do parâmetro lpAddress até (lpAddress+dwSize). Isso significa que um intervalo de 2 bytes que atravessa um limite de página faz com que ambas as páginas sejam desbloqueadas.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

Para que a função tenha êxito, o intervalo especificado não precisa corresponder a um intervalo passado para uma chamada anterior para a função VirtualLock , mas todas as páginas no intervalo devem ser bloqueadas. Se qualquer uma das páginas no intervalo especificado não estiver bloqueada, VirtualUnlock removerá essas páginas do conjunto de trabalho, definirá o último erro como ERROR_NOT_LOCKED e retornará FALSE.

Chamar VirtualUnlock em um intervalo de memória que não está bloqueado libera as páginas do conjunto de trabalho do processo.

Requisitos

   
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho memoryapi.h (inclua Windows.h, Memoryapi.h)
Biblioteca onecore.lib
DLL Kernel32.dll

Confira também

Funções de gerenciamento da memória

Funções de memória virtual

VirtualLock