Função Wow64SetThreadContext (wow64apiset.h)

Define o contexto do thread WOW64 especificado.

Sintaxe

BOOL Wow64SetThreadContext(
  [in] HANDLE              hThread,
  [in] const WOW64_CONTEXT *lpContext
);

Parâmetros

[in] hThread

Um identificador para o thread cujo contexto deve ser definido.

[in] lpContext

Uma estrutura WOW64_CONTEXT . O chamador deve inicializar o membro ContextFlags dessa estrutura.

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 permite que o contexto seletivo seja definido com base no valor do membro ContextFlags da estrutura de contexto. O identificador de thread identificado pelo parâmetro hThread normalmente está sendo depurado, mas a função também pode operar mesmo quando não está sendo depurada.

Essa função destina-se a aplicativos de 64 bits. Não há suporte para ele no Windows de 32 bits; essas chamadas falham e definem o último código de erro como ERROR_INVALID_FUNCTION. Um aplicativo de 32 bits pode chamar essa função em um thread WOW64; o resultado é o mesmo que chamar a função SetThreadContext .

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

Requisitos

Consulte também

Funções de depuração de

GetXStateFeaturesMask

SetThreadContext

SetXStateFeaturesMask

WOW64_CONTEXT

Wow64GetThreadContext