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

Статья
03/13/2024

Извлекает сведения о символах для следующего символа.

Синтаксис

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 или более поздней версии

См. также раздел

Функции DbgHelp

SYMBOL_INFO

SymPrev

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