Funzione SetProcessAffinityUpdateMode (processthreadsapi.h)

Imposta la modalità di aggiornamento dell'affinità del processo specificato.

Sintassi

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

Parametri

[in] hProcess

Handle per il processo. Questo handle deve essere restituito dalla funzione GetCurrentProcess .

[in] dwFlags

Modalità di aggiornamento dell'affinità. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
0	Disabilita l'aggiornamento dinamico dell'affinità del processo dal sistema.
PROCESS_AFFINITY_ENABLE_AUTO_UPDATE 0x00000001UL	Abilita l'aggiornamento dinamico dell'affinità del processo dal sistema.

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

Il sistema può modificare l'affinità di processo in diverse condizioni, ad esempio quando viene aggiunto un processore in modo dinamico. Per impostazione predefinita, gli aggiornamenti dinamici all'affinità del processo sono disabilitati per ogni processo.

I processi devono usare questa funzione per indicare se possono gestire la regolazione dinamica dell'affinità di processo dal sistema. Dopo che un processo abilita la modalità di aggiornamento dell'affinità, può chiamare questa funzione per disabilitarla. Tuttavia, un processo non può abilitare la modalità di aggiornamento dell'affinità dopo aver usato questa funzione per disabilitarla.

I processi figlio non ereditano la modalità di aggiornamento affinità del processo padre. La modalità di aggiornamento dell'affinità deve essere impostata in modo esplicito per ogni processo figlio.

Per compilare un'applicazione che chiama questa funzione, definire _WIN32_WINNT come 0x0600 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	processthreadsapi.h (includere Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

QueryProcessAffinityUpdateMode