Compartilhar via


Função SetProcessAffinityUpdateMode (processthreadsapi.h)

Define o modo de atualização de afinidade do processo especificado.

Sintaxe

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

Parâmetros

[in] hProcess

Um identificador para o processo. Esse identificador deve ser retornado pela função GetCurrentProcess .

[in] dwFlags

O modo de atualização de afinidade. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
0
Desabilita a atualização dinâmica da afinidade de processo pelo sistema.
PROCESS_AFFINITY_ENABLE_AUTO_UPDATE
0x000000001UL
Habilita a atualização dinâmica da afinidade de processo pelo sistema.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O sistema pode ajustar a afinidade de processo em várias condições, como quando um processador é adicionado dinamicamente. Por padrão, as atualizações dinâmicas para a afinidade de processo são desabilitadas para cada processo.

Os processos devem usar essa função para indicar se podem lidar com o ajuste dinâmico da afinidade de processo pelo sistema. Depois que um processo habilita o modo de atualização de afinidade, ele pode chamar essa função para desabilitá-la. No entanto, um processo não pode habilitar o modo de atualização de afinidade depois de usar essa função para desabilitá-la.

Os processos filho não herdam o modo de atualização de afinidade do processo pai. O modo de atualização de afinidade deve ser definido explicitamente para cada processo filho.

Para compilar um aplicativo que chama essa função, defina _WIN32_WINNT como 0x0600 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho processthreadsapi.h (inclua Windows.h no Windows 7, Windows Server 2008 Windows Server 2008 R2)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

QueryProcessAffinityUpdateMode