VirtualFreeEx

9/8/2008

Essa função libera ou decommits, ou ambos, uma região de páginas dentro de espaço de endereço virtual do processo especificado.

Syntax

BOOL VirtualFreeEx(
  HANDLE hProcess,
  LPVOID lpAddress,
  DWORD dwSize,
  DWORD dwFreeType
);

Parameters

• hProcess
  [no] Processo identificador, ou um identificador processo retornados de uma chamar a função de OpenProcess.

• lpAddress
  [no] Ponteiro para o endereço de base da região de páginas a ser liberada.

  Se a pasta dwFreeType parâmetro inclui o sinalizador MEM_RELEASE, este parâmetro deve ser o endereço básico retornado pela função a VirtualAllocEx quando a região de páginas foi reservada.

• dwSize
  [no] Especifica o tamanho, em bytes, da região a ser liberada.

  Se a pasta dwFreeType parâmetro inclui o sinalizador MEM_RELEASE, este parâmetro deve ser zero.

  Caso contrário, a região de páginas afetadas inclui todas as páginas que contêm um ou mais bytes no intervalo a partir de lpAddress parâmetro para (lpAddress + dwSize). Isso significa que um 2-intervalo byte espalhados um limite página faz com que ambas as páginas ser liberado.

• dwFreeType
  [no] Especifica o tipo de livre operação.

  Você pode especificar um do seguinte sinalizadores.

  Valor	Descrição
  MEM_DECOMMIT	Decommits a região especificada de páginas confirmadas. Uma tentativa decommit uma página não confirmada não causar a função falha. Isso significa que um intervalo de páginas confirmadas ou Não Confirmadas pode ser decommitted sem sendo preocupado sobre uma falha.
  MEM_RELEASE	Libera a região especificada de páginas reservadas. Se este sinalizador for especificado, o dwSize parâmetro deve ser zero ou a função falhará.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Para obter mais informações, consulte VirtualFree.

Requirements

Header	winbase.h
Library	coredll.lib
Windows Embedded CE	Windows Embedded CE 6.0 and later

See Also

Reference

Memory Management Functions
VirtualCopyEx
VirtualAllocEx
VirtualAllocCopyEx
OpenProcess

Other Resources

Kernel Migration