IHostMemoryManager::VirtualFree (Método)
Actúa como contenedor lógico para la función de Win32 correspondiente. La implementación de Win32 de VirtualFree lanza, anula la confirmación, o lanza y anula la confirmación de una región de páginas en el espacio de direcciones virtuales del proceso de llamada.
Sintaxis
HRESULT VirtualFree (
[in] LPVOID lpAddress,
[in] SIZE_T dwSize,
[in] DWORD dwFreeType
);
Parámetros
lpAddress
[in] Puntero a la dirección base de las páginas de memoria virtual que se van a liberar.
dwSize
[in] Tamaño, en bytes, de la región que se va a liberar.
dwFreeType
[in] Tipo de operación de liberación.
Valor devuelto
| HRESULT | Descripción |
|---|---|
| S_OK | VirtualFree se devolvió correctamente. |
| HOST_E_CLRNOTAVAILABLE | El Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado o procesar la llamada correctamente. |
| HOST_E_TIMEOUT | Se agotó el tiempo de espera de la llamada. |
| HOST_E_NOT_OWNER | El autor de la llamada no es el propietario del bloqueo. |
| HOST_E_ABANDONED | Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando. |
| E_FAIL | Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE. |
| HOST_E_INVALIDOPERATION | Se ha intentado liberar memoria que no se ha asignado mediante el host. |
Comentarios
VirtualFree libera páginas de memoria virtual asociadas al parámetro lpAddress mediante una llamada anterior a la función IHostMemoryManager::VirtualAlloc. Los intentos de liberar memoria que no se han asignado mediante el host deben devolver HOST_E_INVALIDOPERATION.
La semántica es idéntica a la de la implementación de Win32 de VirtualFree. Para obtener más información, vea la documentación de la Plataforma de Windows.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: MSCorEE.h
Biblioteca: incluida como recurso en MSCorEE.dll
Versiones de .NET Framework: disponible a partir de la versión 2.0
