Compartir a través de

IHostMemoryManager::VirtualFree (Método)

  • Artículo

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

Consulte también