Função SetThreadContext (processthreadsapi.h)
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 |