Metodo IHostMemoryManager::VirtualFree
Funziona come wrapper logico per la funzione Win32 corrispondente. L'implementazione Win32 delle versioni di VirtualFree libera oppure rilascia e libera un'area di pagine all'interno dello spazio di indirizzi virtuale del processo chiamante.
HRESULT VirtualFree (
[in] LPVOID lpAddress,
[in] SIZE_T dwSize,
[in] DWORD dwFreeType
);
Parametri
lpAddress
[in] Puntatore all'indirizzo di base delle pagine della memoria virtuale da liberare.dwSize
[in] Dimensione, in byte, dell'area di memoria da liberare.dwFreeType
[in] Tipo di operazione per la liberazione della memoria.
Valore restituito
HRESULT |
Oggetto di descrizione |
---|---|
S_OK |
VirtualFree ha restituito correttamente un valore. |
HOST_E_CLRNOTAVAILABLE |
Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata. |
HOST_E_TIMEOUT |
Timeout della chiamata. |
HOST_E_NOT_OWNER |
Il chiamante non è il proprietario del blocco. |
HOST_E_ABANDONED |
Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento. |
E_FAIL |
Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE. |
HOST_E_INVALIDOPERATION |
Tentativo di liberare memoria non allocata tramite l'host. |
Note
VirtualFree libera le pagine della memoria virtuale associate al parametro lpAddress tramite una precedente chiamata alla funzione IHostMemoryManager::VirtualAlloc. Se si tenta di liberare memoria non allocata tramite l'host, dovrà essere restituito HOST_E_INVALIDOPERATION.
La semantica è identica a quella dell'implementazione Win32 di VirtualFree. Per ulteriori informazioni, vedere la documentazione relativa alla piattaforma Windows.
Requisiti
Piattaforme: vedere Requisiti di sistema di .NET Framework.
Intestazione: MSCorEE.h
Libreria: inclusa come risorsa in MSCorEE.dll
Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0