Função SetThreadContext (processthreadsapi.h)

Artigo
08/25/2023

Define o contexto para a thread especificada.

Um aplicativo de 64 bits pode definir o contexto de um thread WOW64 usando a função Wow64SetThreadContext .

Sintaxe

BOOL SetThreadContext(
  [in] HANDLE        hThread,
  [in] const CONTEXT *lpContext
);

Parâmetros

[in] hThread

Um identificador para o thread cujo contexto deve ser definido. O identificador deve ter o acesso THREAD_SET_CONTEXT diretamente ao thread. Para obter mais informações, consulte Segurança de thread e direitos de acesso.

[in] lpContext

Um ponteiro para uma estrutura CONTEXT que contém o contexto a ser definido no thread especificado. O valor do membro ContextFlags dessa estrutura especifica quais partes do contexto de um thread definir. Alguns valores na estrutura CONTEXT que não podem ser especificados são silenciosamente definidos como o valor correto. Isso inclui bits no registro de status da CPU que especificam o modo de processador privilegiado, bits de habilitação global no registro de depuração e outros estados que devem ser controlados pelo sistema operacional.

Valor retornado

Se o contexto tiver sido definido, 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

A função define o contexto de thread 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 mesmo quando o thread não está sendo depurado.

Não tente definir o contexto para um thread em execução; os resultados são imprevisíveis. Use a função SuspendThread para suspender o thread antes de chamar SetThreadContext.

Requisitos


Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	processthreadsapi.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll