Compartilhar via

Função GetThreadContext (processthreadsapi.h)

  • Artigo

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 acesso THREAD_GET_CONTEXT ao thread. Para obter mais informações, consulte de Direitos de Acesso e Segurança do Thread.

Windows XP ou Windows Server 2003: O identificador também deve ter acesso THREAD_QUERY_INFORMATION.

[in, out] lpContext

Um ponteiro para uma estrutura de CONTEXT de (como ARM64_NT_CONTEXT) que recebe o contexto apropriado do thread especificado. O valor do ContextFlags membro 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 definições específicas do processador dessas estruturas e quaisquer requisitos de alinhamento.

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

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 ContextFlags membro 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.

Você não pode 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
de cliente com suporte mínimo Windows XP [aplicativos da área de trabalho | Aplicativos UWP]
servidor com suporte mínimo Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
cabeçalho processthreadsapi.h (inclua Windows.h)
biblioteca Kernel32.lib
de DLL Kernel32.dll

Consulte também