Функция 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 или более поздней версии |