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

Инициирует мониторинг рабочего набора указанного процесса. Эту функцию необходимо вызвать перед вызовом функции GetWsChanges .

Синтаксис

BOOL InitializeProcessForWsWatch(
  [in] HANDLE hProcess
);

Параметры

[in] hProcess

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

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

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

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

Комментарии

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

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

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

Требования

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

EnumProcesses

GetWsChanges

Функции PSAPI

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