Función SetThreadContext (processthreadsapi.h)
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 |