Функция SymEnumSymbolsForAddrW (dbghelp.h)
Перечисляет символы для указанного адреса.
Синтаксис
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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 6.0 или более поздней версии |