Функция SymNext (dbghelp.h)
Извлекает сведения о символах для следующего символа.
Синтаксис
BOOL IMAGEAPI SymNext(
[in] HANDLE hProcess,
[in, out] PSYMBOL_INFO si
);
Параметры
[in] hProcess
Дескриптор процесса. Этот дескриптор должен быть ранее передан в функцию SymInitialize .
[in, out] si
Указатель на структуру SYMBOL_INFO , которая предоставляет сведения о текущем символе. После возврата структура содержит сведения о следующем символе.
Возвращаемое значение
Если функция выполнена успешно, возвращается значение TRUE.
Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.
Комментарии
Эта функция требует, чтобы структура SYMBOL_INFO имели допустимые данные для текущего символа. Следующий символ — это символ с виртуальным адресом, который является следующим в последовательности.
Все функции DbgHelp, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.
Чтобы вызвать версию юникода этой функции, определите DBGHELP_TRANSLATE_TCHAR.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 6.2 или более поздней версии |