Metodo IHostMemoryManager::VirtualFree

Articolo
04/08/2023

Funge da wrapper logico per la funzione Win32 corrispondente. L'implementazione Win32 di VirtualFree versioni, decommits o versioni e decommette un'area di pagine all'interno dello spazio indirizzi virtuale del processo chiamante.

Sintassi

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

Parametri

lpAddress
[in] Puntatore all'indirizzo di base delle pagine di memoria virtuale da liberare.

dwSize
[in] Dimensioni, in byte, dell'area da liberare.

dwFreeType
[in] Tipo di operazione di liberamento.

Valore restituito

HRESULT	Descrizione
S_OK	`VirtualFree` restituito correttamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non possiede il blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread bloccato o fibra era in attesa su di esso.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Quando un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE.
HOST_E_INVALIDOPERATION	È stato effettuato un tentativo di liberare memoria non allocata tramite l'host.

Commenti

VirtualFree libera pagine di memoria virtuale associate lpAddress al parametro tramite una chiamata precedente alla funzione IHostMemoryManager::VirtualAlloc . I tentativi di liberare memoria non allocata tramite l'host devono restituire HOST_E_INVALIDOPERATION.

La semantica è identica a quella dell'implementazione win32 di VirtualFree. Per altre informazioni, vedere la documentazione di Windows Platform.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile da 2.0

Condividi tramite