Sdílet prostřednictvím


IHostMemoryManager::VirtualFree – metoda

Slouží jako logický obálka pro odpovídající funkci Win32. Implementace vydaných VirtualFree verzí, dekomisací nebo vydaných verzí a dekommituje win32 oblast stránek v rámci virtuálního adresního prostoru volajícího procesu.

Syntaxe

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

Parametry

lpAddress
[v] Ukazatel na základní adresu stránek virtuální paměti, které se mají uvolnit.

dwSize
[v] Velikost oblasti, která se má uvolnit, v bajtech.

dwFreeType
[v] Typ operace uvolnění.

Návratová hodnota

HRESULT Description
S_OK VirtualFree úspěšně vráceno.
HOST_E_CLRNOTAVAILABLE Modul CLR (Common Language Runtime) nebyl načten do procesu nebo je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání.
HOST_E_TIMEOUT Časový limit hovoru vypršel.
HOST_E_NOT_OWNER Volající zámek nevlastní.
HOST_E_ABANDONED Událost byla zrušena, když na ni čekalo blokované vlákno nebo vlákno.
E_FAIL Došlo k neznámému katastrofickému selhání. Když metoda vrátí E_FAIL, CLR už není v rámci procesu použitelný. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE.
HOST_E_INVALIDOPERATION Došlo k pokusu o uvolnění paměti, která nebyla přidělena prostřednictvím hostitele.

Poznámky

VirtualFree uvolní stránky virtuální paměti přidružené k parametru lpAddress prostřednictvím dřívějšího volání funkce IHostMemoryManager::VirtualAlloc . Pokusy o uvolnění paměti, která nebyla přidělena prostřednictvím hostitele, by se měly vrátit HOST_E_INVALIDOPERATION.

Sémantika je shodná s implementací Win32 .VirtualFree Další informace najdete v dokumentaci k platformě Windows.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MSCorEE.h

Knihovny: Zahrnuto jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Viz také