Funzione EmptyWorkingSet (psapi.h)

Rimuove il maggior numero possibile di pagine dal working set del processo specificato.

Sintassi

BOOL EmptyWorkingSet(
  [in] HANDLE hProcess
);

Parametri

[in] hProcess

Handle per il processo. L'handle deve avere il diritto di accesso PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION e il diritto di accesso PROCESS_SET_QUOTA . Per altre informazioni, vedere Sicurezza dei processi e diritti di accesso.

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

È anche possibile svuotare il working set chiamando la funzione SetProcessWorkingSetSize o SetProcessWorkingSetSizeEx con i parametri dwMinimumWorkingSetSize e dwMaximumWorkingSetSize impostati sul valore (SIZE_T)(-1).

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 K32EmptyWorkingSet in Psapi.h ed esportata in Kernel32.lib e Kernel32.dll. Se PSAPI_VERSION è 1, questa funzione viene definita come K32EmptyWorkingSet in Psapi.h ed esportata in Psapi.lib e Psapi.dll come wrapper che chiama K32EmptyWorkingSet.

I programmi che devono essere eseguiti in versioni precedenti di Windows e Windows 7 e versioni successive devono sempre chiamare questa funzione come K32EmptyWorkingSet. 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

SetProcessWorkingSetSize

Working Set

Informazioni sul working set