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

Статья
11/20/2024

Перечисляет символы для указанного адреса.

Синтаксис

BOOL IMAGEAPI SymEnumSymbolsForAddrW(
  [in]           HANDLE                          hProcess,
  [in]           DWORD64                         Address,
  [in]           PSYM_ENUMERATESYMBOLS_CALLBACKW EnumSymbolsCallback,
  [in, optional] PVOID                           UserContext
);

Параметры

[in] hProcess

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

[in] Address

Адрес, для которого должны находиться символы. Адрес не должен находиться на границе символа. Если адрес поступает после начала символа и до конца символа (начало символа плюс размер символа), функция найдет этот символ.

[in] EnumSymbolsCallback

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

[in, optional] UserContext

Необязательные пользовательские данные. Это значение передается функции обратного вызова.

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

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

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

Замечания

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

Чтобы вызвать версию этой функции Юникода, определите DBGHELP_TRANSLATE_TCHAR.

Заметка

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

Требования

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

См. также

функций DbgHelp

SymEnumSymbolsProc

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