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

Статья
11/20/2024

Извлекает область для указанного индекса.

Синтаксис

BOOL IMAGEAPI SymGetScopeW(
  [in]      HANDLE        hProcess,
  [in]      ULONG64       BaseOfDll,
  [in]      DWORD         Index,
  [in, out] PSYMBOL_INFOW Symbol
);

Параметры

[in] hProcess

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

[in] BaseOfDll

Базовый адрес модуля.

[in] Index

Уникальное значение для символа.

[in, out] Symbol

Указатель на структуру SYMBOL_INFO. Элемент области содержит область.

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

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

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

Замечания

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

Заметка

Заголовок dbghelp.h определяет SymGetScope как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	dbghelp.h
библиотеки	Dbghelp.lib
DLL	Dbghelp.dll
распространяемый	DbgHelp.dll 6.2 или более поздней версии

См. также

функций DbgHelp

SYMBOL_INFO

SymSetScopeFromAddr

SymSetScopeFromIndex

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