Función SetThreadContext (processthreadsapi.h)

Establece el contexto del subproceso especificado.

Sintaxis

BOOL SetThreadContext(
  [in] HANDLE        hThread,
  [in] const CONTEXT *lpContext
);

Parámetros

[in] hThread

Identificador del subproceso cuyo contexto se va a establecer. El identificador debe tener el THREAD_SET_CONTEXT derecho de acceso al subproceso. Para obtener más información, consulte derechos de acceso y seguridad de subprocesos.

[in] lpContext

Puntero a una estructura CONTEXT que contiene el contexto que se va a establecer en el subproceso especificado. El valor del miembro ContextFlags de esta estructura especifica qué partes del contexto de un subproceso se va a establecer. Algunos valores de la estructura CONTEXT que no se pueden especificar se establecen silenciosamente en el valor correcto. Esto incluye bits en el registro de estado de CPU que especifican el modo de procesador con privilegios, los bits globales que habilitan bits en el registro de depuración y otros estados que el sistema operativo debe controlar.

Valor devuelto

Si se estableció el contexto, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

La función establece el contexto del subproceso en función del valor del miembro ContextFlags de la estructura de contexto. Normalmente, el subproceso identificado por el parámetro hThread se está depurando, pero la función también puede funcionar incluso cuando el subproceso no se está depurando.

No intente establecer el contexto de un subproceso en ejecución; los resultados son imprevisibles. Use la función SuspendThread para suspender el subproceso antes de llamar a SetThreadContext.

Requisitos

Consulte también

CONTEXT de

funciones de depuración

GetThreadContext

GetXStateFeaturesMask

SetXStateFeaturesMask

SuspendThread