Функция SetProcessAffinityUpdateMode (processthreadsapi.h)

  • Статья

Задает режим обновления сходства указанного процесса.

Синтаксис

BOOL SetProcessAffinityUpdateMode(
  [in] HANDLE hProcess,
  [in] DWORD  dwFlags
);

Параметры

[in] hProcess

Дескриптор процесса. Этот дескриптор должен быть возвращен функцией GetCurrentProcess .

[in] dwFlags

Режим обновления сходства. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
0
 Отключает динамическое обновление сопоставления процессов системой.
PROCESS_AFFINITY_ENABLE_AUTO_UPDATE
0x00000001UL
 Включает динамическое обновление сходства процессов системой.

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

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

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

Комментарии

Система может настраивать сходство процессов при различных условиях, например при динамическом добавлении процессора. По умолчанию динамические обновления сопоставления процессов отключены для каждого процесса.

Процессы должны использовать эту функцию, чтобы указать, могут ли они обрабатывать динамическое изменение сходства процессов системой. После включения режима обновления сходства процесс может вызвать эту функцию, чтобы отключить ее. Однако процесс не может включить режим обновления сходства после использования этой функции для его отключения.

Дочерние процессы не наследуют режим обновления сходства родительского процесса. Режим обновления сходства должен быть явно задан для каждого дочернего процесса.

Чтобы скомпилировать приложение, которое вызывает эту функцию, определите _WIN32_WINNT как 0x0600 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Требования

Требование Значение
Минимальная версия клиента Windows Vista с пакетом обновления 1 (SP1) [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header processthreadsapi.h (включая Windows.h в Windows 7, Windows Server 2008 Windows Server 2008 R2)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

QueryProcessAffinityUpdateMode