Método de IHostMemoryManager::VirtualFree
Serve como um wrapper lógico para a função correspondente do Win32. A implementação do Win32 de VirtualFree versões, decommits, ou versões e decommits uma região de páginas dentro do espaço de endereço virtual do processo de chamada.
HRESULT VirtualFree (
[in] LPVOID lpAddress,
[in] SIZE_T dwSize,
[in] DWORD dwFreeType
);
Parâmetros
lpAddress
[in] Um ponteiro para o endereço base das páginas de memória virtual para ser liberado.dwSize
[in] O tamanho em bytes, da região para ser liberado.dwFreeType
[in] O tipo de operação de liberação.
Valor de retorno
HRESULT |
Descrição |
|---|---|
S_OK |
VirtualFreeretornado com êxito. |
HOST_E_CLRNOTAVAILABLE |
O common language runtime (CLR) não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito. |
HOST_E_TIMEOUT |
A chamada foi esgotado. |
HOST_E_NOT_OWNER |
O chamador não possui o bloqueio. |
HOST_E_ABANDONED |
Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele. |
E_FAIL |
Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE. |
HOST_E_INVALIDOPERATION |
Foi feita uma tentativa de liberar memória que não foi alocada pelo host. |
Comentários
VirtualFreelibera as páginas de memória virtual associadas a lpAddress parâmetro por meio de uma chamada anterior para o IHostMemoryManager::VirtualAlloc função. Tentativas para liberar memória que não foi alocada pelo host devem retornar HOST_E_INVALIDOPERATION.
A semântica é idêntica da implementação do Win32 VirtualFree. Para obter mais informações, consulte a documentação da plataforma Windows.
Requisitos
Plataformas: Consulte Requisitos de sistema do .NET Framework.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso em mscoree
.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0