Função GetThreadContext (processthreadsapi.h)
Recupera o contexto do thread especificado.
Um aplicativo de 64 bits pode recuperar o contexto de um thread WOW64 usando o Wow64GetThreadContext.
Sintaxe
BOOL GetThreadContext(
[in] HANDLE hThread,
[in, out] LPCONTEXT lpContext
);
Parâmetros
[in] hThread
Um identificador para o thread cujo contexto deve ser recuperado. O identificador deve ter THREAD_GET_CONTEXT acesso ao thread. Para obter mais informações, consulte Segurança de thread e direitos de acesso.
Windows XP ou Windows Server 2003: O identificador também deve ter acesso THREAD_QUERY_INFORMATION .
[in, out] lpContext
Um ponteiro para uma estrutura CONTEXT (como ARM64_NT_CONTEXT) que recebe o contexto apropriado do thread especificado. O valor do membro ContextFlags dessa estrutura especifica quais partes do contexto de um thread são recuperadas. A estrutura CONTEXT é altamente específica do processador. Consulte o arquivo de cabeçalho WinNT.h para obter definições específicas do processador dessas estruturas e quaisquer requisitos de alinhamento.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Essa função é usada para recuperar o contexto de thread do thread especificado. A função recupera um contexto seletivo com base no valor do membro ContextFlags da estrutura de contexto. O thread identificado pelo parâmetro hThread normalmente está sendo depurado, mas a função também pode operar quando o thread não está sendo depurado.
Não é possível obter um contexto válido para um thread em execução. Use a função SuspendThread para suspender o thread antes de chamar GetThreadContext.
Se você chamar GetThreadContext para o thread atual, a função retornará com êxito; no entanto, o contexto retornado não é válido.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | processthreadsapi.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |