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

Извлекает контекст указанного потока WOW64.

Синтаксис

BOOL Wow64GetThreadContext(
  [in]      HANDLE         hThread,
  [in, out] PWOW64_CONTEXT lpContext
);

Параметры

[in] hThread

Дескриптор потока, контекст которого требуется извлечь. Дескриптор должен иметь THREAD_GET_CONTEXT доступ к потоку. Дополнительные сведения см. в разделе Thread Security and Access Rights.

[in, out] lpContext

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

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

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

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

Замечания

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

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

При вызове Wow64GetThreadContext для текущего потока функция возвращается успешно; Однако возвращаемый контекст недопустим.

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

Требования

См. также

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

Функция GetThreadContext

GetXStateFeaturesMask

WOW64_CONTEXT

Wow64SetThreadContext