Función QueryWorkingSet (psapi.h)

Recupera información sobre las páginas agregadas actualmente al conjunto de trabajo del proceso especificado.

Para recuperar información del espacio de trabajo de un subconjunto de direcciones virtuales, o para recuperar información sobre las páginas que no forman parte del espacio de trabajo (como AWE o páginas grandes), use la función QueryWorkingSetEx .

Sintaxis

BOOL QueryWorkingSet(
  [in]  HANDLE hProcess,
  [out] PVOID  pv,
  [in]  DWORD  cb
);

Parámetros

[in] hProcess

Identificador del proceso. El identificador debe tener los derechos de acceso PROCESS_QUERY_INFORMATION y PROCESS_VM_READ . Para obtener más información, consulte Derechos de acceso y seguridad de procesos.

[out] pv

Puntero al búfer que recibe la información. Para obtener más información, consulte PSAPI_WORKING_SET_INFORMATION.

Si el búfer al que apunta el parámetro pv no es lo suficientemente grande como para contener todas las entradas del conjunto de trabajo para el proceso de destino, se produce un error en la función con ERROR_BAD_LENGTH. En este caso, el miembro NumberOfEntries de la estructura PSAPI_WORKING_SET_INFORMATION se establece en el número necesario de entradas, pero la función no devuelve información sobre las entradas del conjunto de trabajo.

[in] cb

Tamaño del búfer pv , en bytes.

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

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 K32QueryWorkingSet en Psapi.h y exportada en Kernel32.lib y Kernel32.dll. Si PSAPI_VERSION es 1, esta función se define como QueryWorkingSet en Psapi.h y exportada en Psapi.lib y Psapi.dll como contenedor que llama a K32QueryWorkingSet.

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 QueryWorkingSet. 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

PSAPI_WORKING_SET_INFORMATION

QueryWorkingSetEx

Información del conjunto de trabajo