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

Статья
02/26/2024

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

Синтаксис

BOOL IMAGEAPI SymFromName(
  [in]      HANDLE       hProcess,
  [in]      PCSTR        Name,
  [in, out] PSYMBOL_INFO Symbol
);

Параметры

[in] hProcess

Дескриптор процесса. Этот дескриптор должен быть ранее передан в функцию SymInitialize .

[in] Name

Имя расположенного символа.

[in, out] Symbol

Указатель на структуру SYMBOL_INFO , предоставляющую сведения о символе.

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

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

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

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

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

Примеры

Пример см. в разделе Получение сведений о символах по имени.

Требования

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

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

Функции DbgHelp

SYMBOL_INFO

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