Função SetThreadContext (processthreadsapi.h)

Define o contexto do thread especificado.

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 de Direitos de Acesso e Segurança do Thread.

[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 devem ser definidas. 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, os bits de habilitação global no registro de depuração e outros estados que devem ser controlados pelo sistema operacional.

Valor de retorno

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

A função define o contexto do 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

Consulte também

CONTEXTO

Funções de depuração de

GetThreadContext

GetXStateFeaturesMask

SetXStateFeaturesMask

SuspendThread