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

Статья
08/23/2023

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

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

Синтаксис

BOOL IMAGEAPI SymGetSymNext(
  [in]      HANDLE           hProcess,
  [in, out] PIMAGEHLP_SYMBOL Symbol
);

Параметры

[in] hProcess

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

[in, out] Symbol

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

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

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

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

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

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

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

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

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

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetSymNext SymGetSymNext64
#define SymGetSymNextW SymGetSymNextW64
#else
BOOL
IMAGEAPI
SymGetSymNext(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_SYMBOL Symbol
    );

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

Требования

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