Función SetThreadContext (processthreadsapi.h)

Artículo
08/25/2023

Establece el contexto del subproceso especificado.

Una aplicación de 64 bits puede establecer el contexto de un subproceso WOW64 mediante la función Wow64SetThreadContext .

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 van 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 de habilitación global 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 la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función establece el contexto del subproceso en función del valor del miembro ContextFlags de la estructura de contexto. El subproceso identificado por el parámetro hThread normalmente 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


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	processthreadsapi.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll