Compartir a través de

Función GetThreadContext (processthreadsapi.h)

  • Artículo

Recupera el contexto del subproceso especificado.

Una aplicación de 64 bits puede recuperar el contexto de un subproceso WOW64 mediante el Wow64GetThreadContext.

Sintaxis

BOOL GetThreadContext(
  [in]      HANDLE    hThread,
  [in, out] LPCONTEXT lpContext
);

Parámetros

[in] hThread

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

Windows XP o Windows Server 2003: El identificador también debe tener acceso THREAD_QUERY_INFORMATION.

[in, out] lpContext

Puntero a una estructura de CONTEXT (como ARM64_NT_CONTEXT) que recibe el contexto adecuado del subproceso especificado. El valor del ContextFlags miembro de esta estructura especifica qué partes del contexto de un subproceso se recuperan. La estructura CONTEXT es muy específica del procesador. Consulte el archivo de encabezado WinNT.h para conocer las definiciones específicas del procesador de estas estructuras y los requisitos de alineación.

Valor devuelto

Si la función se ejecuta correctamente, 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

Esta función se usa para recuperar el contexto de subproceso del subproceso especificado. La función recupera un contexto selectivo basado en el valor del ContextFlags miembro 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 cuando el subproceso no se está depurando.

No se puede obtener un contexto válido para un subproceso en ejecución. Use la función SuspendThread de para suspender el subproceso antes de llamar a GetThreadContext.

Si llama a GetThreadContext para el subproceso actual, la función devuelve correctamente; sin embargo, el contexto devuelto no es válido.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
encabezado de processthreadsapi.h (incluya Windows.h)
biblioteca de Kernel32.lib
DLL de Kernel32.dll

Consulte también