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

Статья
11/20/2024

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

Синтаксис

BOOL IMAGEAPI SymFromInlineContextW(
  [in]            HANDLE        hProcess,
  [in]            DWORD64       Address,
  [in]            ULONG         InlineContext,
  [out, optional] PDWORD64      Displacement,
  [in, out]       PSYMBOL_INFOW Symbol
);

Параметры

[in] hProcess

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

[in] Address

Адрес, для которого должен находиться символ. Адрес не должен находиться на границе символа. Если адрес поступает после начала символа и до конца символа, он найден.

[in] InlineContext

Встроенный контекст, для которого должен находиться символ.

[out, optional] Displacement

Смещение от начала символа или нуля.

[in, out] Symbol

Указатель на SYMBOL_INFO структуру, которая предоставляет сведения о символе. Имя символа является переменной длины; поэтому этот буфер должен быть достаточно большим, чтобы сохранить имя, хранящееся в конце структуры SYMBOL_INFO. Не забудьте задать элемент MaxNameLen число байтов, зарезервированных для имени.

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

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

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

Замечания

Заметка

Заголовок dbghelp.h определяет SymFromInlineContext как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	dbghelp.h
библиотеки	DbgHelp.lib
DLL	DbgHelp.dll
распространяемый	DbgHelp.dll 6.2 или более поздней версии

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