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

Статья
08/23/2023

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

Синтаксис

BOOL IMAGEAPI SymPrev(
  [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

SymNext

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