Methode IHostMemoryManager::VirtualFree

Artikel
05/10/2023

Fungeert als een logische wrapper voor de bijbehorende Win32-functie. De Win32-implementatie van VirtualFree releases, het ongedaan maken van releases of releases en het ongedaan maken van een regio van pagina's binnen de virtuele adresruimte van het aanroepproces.

Syntaxis

HRESULT VirtualFree (  
    [in] LPVOID  lpAddress,  
    [in] SIZE_T  dwSize,  
    [in] DWORD   dwFreeType  
);

Parameters

lpAddress
[in] Een verwijzing naar het basisadres van de virtuele geheugenpagina's die moeten worden vrijgemaakt.

dwSize
[in] De grootte, in bytes, van de regio die moet worden vrijgemaakt.

dwFreeType
[in] Het type vrijgavebewerking.

Retourwaarde

HRESULT	Beschrijving
S_OK	`VirtualFree` is geretourneerd.
HOST_E_CLRNOTAVAILABLE	De COMMON Language Runtime (CLR) is niet geladen in een proces of de CLR heeft een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt.
HOST_E_TIMEOUT	Er is een time-out opgetreden voor het gesprek.
HOST_E_NOT_OWNER	De beller is niet de eigenaar van het slot.
HOST_E_ABANDONED	Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of glasvezel op wachtte.
E_FAIL	Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE.
HOST_E_INVALIDOPERATION	Er is een poging gedaan om geheugen vrij te maken dat niet is toegewezen via de host.

Opmerkingen

VirtualFree Hiermee worden virtuele geheugenpagina's die zijn gekoppeld aan de lpAddress parameter, vrijgemaakt via een eerdere aanroep naar de functie IHostMemoryManager::VirtualAlloc . Pogingen om geheugen vrij te maken dat niet via de host is toegewezen, moeten HOST_E_INVALIDOPERATION retourneren.

De semantiek is identiek aan die van de Win32-implementatie van VirtualFree. Zie de documentatie voor het Windows-platform voor meer informatie.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Delen via