Функция SymEnumSymbolsForAddr (dbghelp.h)
Перечисляет символы для указанного адреса.
Синтаксис
BOOL IMAGEAPI SymEnumSymbolsForAddr(
[in] HANDLE hProcess,
[in] DWORD64 Address,
[in] PSYM_ENUMERATESYMBOLS_CALLBACK EnumSymbolsCallback,
[in, optional] PVOID UserContext
);
Параметры
[in] hProcess
Дескриптор процесса. Этот дескриптор должен быть ранее передан в функцию SymInitialize .
[in] Address
Адрес, для которого должны находиться символы. Адрес не обязательно должен находиться на границе символа. Если адрес приходит после начала символа и до конца символа (начало символа плюс размер символа), функция найдет символ.
[in] EnumSymbolsCallback
Функция обратного вызова, определяемая приложением. Эта функция вызывается для каждого символа, найденного в поле Address. Дополнительные сведения см. в разделе SymEnumSymbolsProc.
[in, optional] UserContext
Необязательные пользовательские данные. Это значение передается в функцию обратного вызова.
Возвращаемое значение
Если функция выполняется успешно, возвращается значение TRUE.
Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.
Комментарии
Все функции DbgHelp, такие как эта, являются однопоточными. Поэтому вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.
Чтобы вызвать версию этой функции в Юникоде, определите DBGHELP_TRANSLATE_TCHAR.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 6.0 или более поздней версии |