IHostMemoryManager::VirtualFree, méthode
Sert de wrapper logique pour la fonction Win32 correspondante. L'implémentation Win32 de VirtualFree libère une région de pages, annule sa validation ou libère une région de pages et annule sa validation dans l'espace d'adresse virtuelle du processus appelant.
HRESULT VirtualFree (
[in] LPVOID lpAddress,
[in] SIZE_T dwSize,
[in] DWORD dwFreeType
);
Paramètres
lpAddress
[in] Pointeur vers l'adresse de base des pages de la mémoire virtuelle à libérer.dwSize
[in] Taille, en octets, de la région à libérer.dwFreeType
[in] Type d'opération de libération.
Valeur de retour
HRESULT |
Description |
|---|---|
S_OK |
VirtualFree a été retourné avec succès. |
HOST_E_CLRNOTAVAILABLE |
Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès. |
HOST_E_TIMEOUT |
L'appel a expiré. |
HOST_E_NOT_OWNER |
L'appelant ne possède pas le verrou. |
HOST_E_ABANDONED |
Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait. |
E_FAIL |
Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE. |
HOST_E_INVALIDOPERATION |
Une tentative a été faite pour libérer de la mémoire qui n'a pas été allouée par le biais de l'hôte. |
Notes
VirtualFree libère des pages mémoire virtuelle associées au paramètre lpAddress via un appel antérieur à la fonction IHostMemoryManager::VirtualAlloc. Des tentatives pour libérer de la mémoire qui n'a pas été allouée par le biais de l'hôte devraient retourner HOST_E_INVALIDOPERATION.
La sémantique est identique à celle de l'implémentation Win32 de VirtualFree. Pour plus d'informations, consultez la documentation de la plateforme Windows.
Configuration requise
Plateformes : consultez Configuration requise du .NET Framework.
En-tête : MSCorEE.h
Bibliothèque : incluse en tant que ressource dans MSCorEE.dll
Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0