Funzione QueryWorkingSet (psapi.h)

Recupera informazioni sulle pagine attualmente aggiunte al set di lavoro del processo specificato.

Per recuperare informazioni sul set di lavoro per un subset di indirizzi virtuali o per recuperare informazioni sulle pagine che non fanno parte del set di lavoro (ad esempio AWE o pagine di grandi dimensioni), usare la funzione QueryWorkingSetEx .

Sintassi

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

Parametri

[in] hProcess

Handle per il processo. L'handle deve avere i diritti di accesso PROCESS_QUERY_INFORMATION e PROCESS_VM_READ . Per altre informazioni, vedere Elaborare diritti di sicurezza e accesso.

[out] pv

Puntatore al buffer che riceve le informazioni. Per altre informazioni, vedere PSAPI_WORKING_SET_INFORMATION.

Se il buffer puntato al parametro pv non è sufficiente per contenere tutte le voci del set di lavoro per il processo di destinazione, la funzione ha esito negativo con ERROR_BAD_LENGTH. In questo caso, il membro NumberOfEntries della struttura PSAPI_WORKING_SET_INFORMATION è impostato sul numero necessario di voci, ma la funzione non restituisce informazioni sulle voci del set di lavoro.

[in] cb

Dimensioni del buffer pv , in byte.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

A partire da Windows 7 e Windows Server 2008 R2, Psapi.h stabilisce i numeri di versione per le funzioni PSAPI. Il numero di versione PSAPI influisce sul nome usato per chiamare la funzione e la libreria che un programma deve caricare.

Se PSAPI_VERSION è 2 o versione successiva, questa funzione viene definita come K32QueryWorkingSet in Psapi.h ed esportata in Kernel32.lib e Kernel32.dll. Se PSAPI_VERSION è 1, questa funzione viene definita come QueryWorkingSet in Psapi.h ed esportata in Psapi.lib e Psapi.dll come wrapper che chiama K32QueryWorkingSet.

I programmi che devono essere eseguiti nelle versioni precedenti di Windows e windows 7 e versioni successive devono sempre chiamare questa funzione come QueryWorkingSet. Per garantire la risoluzione corretta dei simboli, aggiungere Psapi.lib alla macro TARGETLIBS e compilare il programma con -DPSAPI_VERSION=1. Per usare il collegamento dinamico in fase di esecuzione, caricare Psapi.dll.

Requisiti

Vedi anche

EnumProcesses

Funzioni PSAPI

PSAPI_WORKING_SET_INFORMATION

QueryWorkingSetEx

Informazioni sul set di lavoro