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

Статья
08/23/2023

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

Примечание Эта функция предоставляется только для обеспечения совместимости. Приложения должны использовать SymPrev.

Синтаксис

BOOL IMAGEAPI SymGetSymPrev64(
  [in]      HANDLE             hProcess,
  [in, out] PIMAGEHLP_SYMBOL64 Symbol
);

Параметры

[in] hProcess

Дескриптор процесса, который изначально был передан функции SymInitialize .

[in, out] Symbol

Указатель на структуру IMAGEHLP_SYMBOL64 .

Возвращаемое значение

Если функция выполнена успешно, возвращается значение TRUE.

Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.

Функция SymGetSymPrev64 требует, чтобы структура IMAGEHLP_SYMBOL64 должна иметь допустимые данные, предположительно полученные из вызова функции SymGetSymFromAddr64 или SymGetSymFromName64 . Эта структура заполняется сведениями о символах для предыдущего символа в последовательности по виртуальному адресу.

Все функции DbgHelp, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.

Чтобы вызвать версию юникода этой функции, определите DBGHELP_TRANSLATE_TCHAR. SymGetSymPrevW64 определяется в DbgHelp.h следующим образом.

BOOL
IMAGEAPI
SymGetSymPrevW64(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_SYMBOLW64 Symbol
    );

Эта функция заменяет функцию SymGetSymPrev . Дополнительные сведения см. в разделе Обновленная поддержка платформы. SymGetSymPrev определяется в Dbghelp.h следующим образом.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetSymPrev SymGetSymPrev64
#define SymGetSymPrevW SymGetSymPrevW64
#else
BOOL
IMAGEAPI
SymGetSymPrev(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_SYMBOL Symbol
    );

BOOL
IMAGEAPI
SymGetSymPrevW(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_SYMBOLW Symbol
    );
#endif

Требования


Целевая платформа	Windows
Header	dbghelp.h
Библиотека	Dbghelp.lib
DLL	Dbghelp.dll
Распространяемые компоненты	DbgHelp.dll 5.1 или более поздней версии