Función Wow64GetThreadContext (wow64apiset.h)

Recupera el contexto del subproceso WOW64 especificado.

Sintaxis

BOOL Wow64GetThreadContext(
  [in]      HANDLE         hThread,
  [in, out] PWOW64_CONTEXT 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.

[in, out] lpContext

Estructura WOW64_CONTEXT . El autor de la llamada debe inicializar el miembro ContextFlags de esta estructura.

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 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 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 Wow64SuspendThread para suspender el subproceso antes de llamar a Wow64GetThreadContext.

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

Esta función está pensada para aplicaciones de 64 bits. No se admite en Windows de 32 bits; estas llamadas producen un error y establecen el último código de error en ERROR_INVALID_FUNCTION. Una aplicación de 32 bits puede llamar a esta función en un subproceso WOW64; el resultado es el mismo que llamar a la función de función GetThreadContext .

Requisitos

Consulte también

funciones de depuración

Función GetThreadContext

GetXStateFeaturesMask

WOW64_CONTEXT

Wow64SetThreadContext