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 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 CONTEXT (como ARM64_NT_CONTEXT) que recibe el contexto adecuado del subproceso especificado. El valor del miembro ContextFlags 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 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

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 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 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 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 Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado processthreadsapi.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también