Функция EmptyWorkingSet (psapi.h)

Удаляет как можно больше страниц из рабочего набора указанного процесса.

Синтаксис

BOOL EmptyWorkingSet(
  [in] HANDLE hProcess
);

Параметры

[in] hProcess

Дескриптор процесса. Дескриптор должен иметь право доступа PROCESS_QUERY_INFORMATION или PROCESS_QUERY_LIMITED_INFORMATION и право доступа PROCESS_SET_QUOTA . Дополнительные сведения см. в разделе Управление правами на доступ и безопасность процесса.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Можно также очистить рабочий набор, вызвав функцию SetProcessWorkingSetSize или SetProcessWorkingSetSizeEx с параметрами dwMinimumWorkingSetSize и dwMaximumWorkingSetSize , которые имеют значение (SIZE_T)(-1).

Начиная с Windows 7 и Windows Server 2008 R2, Psapi.h устанавливает номера версий для функций PSAPI. Номер версии PSAPI влияет на имя, используемое для вызова функции, и библиотеку, которую должна загрузить программа.

Если PSAPI_VERSION имеет значение 2 или больше, эта функция определяется как K32EmptyWorkingSet в Psapi.h и экспортируется в Kernel32.lib и Kernel32.dll. Если PSAPI_VERSION равно 1, эта функция определяется как K32EmptyWorkingSet в Psapi.h и экспортируется в Psapi.lib и Psapi.dll в качестве оболочки, которая вызывает K32EmptyWorkingSet.

Программы, которые должны работать в более ранних версиях Windows, а также Windows 7 и более поздних версиях, всегда должны вызывать эту функцию как K32EmptyWorkingSet. Чтобы обеспечить правильное разрешение символов, добавьте Psapi.lib в макрос TARGETLIBS и скомпилируйте программу с параметром -DPSAPI_VERSION=1. Чтобы использовать динамическое связывание во время выполнения, загрузите Psapi.dll.

Требования

См. также раздел

EnumProcesses

Функции PSAPI

SetProcessWorkingSetSize

Рабочий набор

Сведения о рабочем наборе