Функция Wow64SetThreadContext (wow64apiset.h)

Задает контекст указанного потока WOW64.

Синтаксис

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

Параметры

[in] hThread

Дескриптор потока, контекст которого необходимо задать.

[in] lpContext

Структура WOW64_CONTEXT . Вызывающий объект должен инициализировать член ContextFlags этой структуры.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение ненулевое.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Эта функция позволяет задать выборочный контекст на основе значения элемента ContextFlags структуры контекста. Дескриптор потока, определяемый параметром hThread , обычно выполняется отладка, но функция также может работать, даже если она не отлаживается.

Эта функция предназначена для 64-разрядных приложений. Он не поддерживается в 32-разрядной версии Windows; такие вызовы завершаются сбоем и задают для последнего кода ошибки ERROR_INVALID_FUNCTION. 32-разрядное приложение может вызывать эту функцию в потоке WOW64; Результат совпадает с вызовом функции SetThreadContext .

Не пытайтесь задать контекст для запущенного потока; Результаты непредсказуемы. Используйте функцию Wow64SuspendThreadThread , чтобы приостановить поток перед вызовом Wow64SetThreadContext.

Требования

См. также

функции отладки

GetXStateFeaturesMask

SetThreadContext

SetXStateFeaturesMask

WOW64_CONTEXT

Wow64GetThreadContext