Поделиться через

Функция SymSetContext (dbghelp.h)

  • Статья

Задает сведения о контексте, используемые функцией SymEnumSymbols . Эта функция работает только с символами PDB.

Синтаксис

BOOL IMAGEAPI SymSetContext(
  [in]           HANDLE                hProcess,
  [in]           PIMAGEHLP_STACK_FRAME StackFrame,
  [in, optional] PIMAGEHLP_CONTEXT     Context
);

Параметры

[in] hProcess

Дескриптор процесса. Этот дескриптор должен быть ранее передан в функцию SymInitialize .

[in] StackFrame

Указатель на структуру IMAGEHLP_STACK_FRAME , содержащую сведения о кадре.

[in, optional] Context

Этот параметр не учитывается.

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

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

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

Комментарии

При вызове SymSetContext для задания контекста текущего значения функция завершается ошибкой, но GetLastError возвращает ERROR_SUCCESS.

Все функции DbgHelp, такие как эта, являются однопоточными. Поэтому вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.

Требования

Требование Значение
Целевая платформа Windows
Header dbghelp.h
Библиотека Dbghelp.lib
DLL Dbghelp.dll
Распространяемые компоненты DbgHelp.dll 5.1 или более поздней версии

См. также раздел

Функции DbgHelp

IMAGEHLP_STACK_FRAME

SymEnumSymbols