Función EmptyWorkingSet (psapi.h)

Quita tantas páginas como sea posible del conjunto de trabajo del proceso especificado.

Sintaxis

BOOL EmptyWorkingSet(
  [in] HANDLE hProcess
);

Parámetros

[in] hProcess

Identificador del proceso. El identificador debe tener el derecho de acceso PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION y el derecho de acceso PROCESS_SET_QUOTA . Para obtener más información, consulte Derechos de acceso y seguridad de procesos.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

También puede vaciar el conjunto de trabajo llamando a la función SetProcessWorkingSetSize o SetProcessWorkingSetSizeEx con los parámetros dwMinimumWorkingSetSize y dwMaximumWorkingSetSize establecidos en el valor (SIZE_T)(-1).

A partir de Windows 7 y Windows Server 2008 R2, Psapi.h establece números de versión para las funciones psapi. El número de versión de PSAPI afecta al nombre usado para llamar a la función y la biblioteca que debe cargar un programa.

Si PSAPI_VERSION es 2 o superior, esta función se define como K32EmptyWorkingSet en Psapi.h y exportada en Kernel32.lib y Kernel32.dll. Si PSAPI_VERSION es 1, esta función se define como K32EmptyWorkingSet en Psapi.h y exportada en Psapi.lib y Psapi.dll como contenedor que llama a K32EmptyWorkingSet.

Los programas que deben ejecutarse en versiones anteriores de Windows, así como Windows 7 y versiones posteriores siempre deben llamar a esta función como K32EmptyWorkingSet. Para garantizar la resolución correcta de símbolos, agregue Psapi.lib a la macro TARGETLIBS y compile el programa con -DPSAPI_VERSION=1. Para usar la vinculación dinámica en tiempo de ejecución, cargue Psapi.dll.

Requisitos

Consulte también

EnumProcesses

Funciones de PSAPI

SetProcessWorkingSetSize

Espacio de trabajo

Información del conjunto de trabajo