Función SetProcessAffinityUpdateMode (processthreadsapi.h)

Establece el modo de actualización de afinidad del proceso especificado.

Sintaxis

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

Parámetros

[in] hProcess

Identificador del proceso. La función GetCurrentProcess debe devolver este identificador.

[in] dwFlags

Modo de actualización de afinidad. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
0	Deshabilita la actualización dinámica de la afinidad de proceso por parte del sistema.
PROCESS_AFFINITY_ENABLE_AUTO_UPDATE 0x00000001UL	Habilita la actualización dinámica de la afinidad de proceso por parte del sistema.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El sistema puede ajustar la afinidad de proceso en varias condiciones, como cuando se agrega un procesador dinámicamente. De forma predeterminada, las actualizaciones dinámicas de la afinidad de proceso se deshabilitan para cada proceso.

Los procesos deben usar esta función para indicar si pueden controlar el ajuste dinámico de la afinidad de proceso por parte del sistema. Una vez que un proceso habilita el modo de actualización de afinidad, puede llamar a esta función para deshabilitarla. Sin embargo, un proceso no puede habilitar el modo de actualización de afinidad después de haber usado esta función para deshabilitarla.

Los procesos secundarios no heredan el modo de actualización de afinidad del proceso primario. El modo de actualización de afinidad debe establecerse explícitamente para cada proceso secundario.

Para compilar una aplicación que llama a esta función, defina _WIN32_WINNT como 0x0600 o posterior. Para obtener más información, vea Usar los encabezados de Windows.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	processthreadsapi.h (incluye Windows.h en Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

QueryProcessAffinityUpdateMode