Метод IDebugSymbols3::GetFunctionEntryByOffset (dbgeng.h)

Метод GetFunctionEntryByOffset возвращает сведения о записи функции для функции.

Синтаксис

HRESULT GetFunctionEntryByOffset(
  [in]            ULONG64 Offset,
  [in]            ULONG   Flags,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BufferNeeded
);

Параметры

[in] Offset

Указывает расположение в виртуальном адресном пространстве текущего процесса реализации функции. Это значение, возвращаемое в параметре смещенияGetNextSymbolMatch и IDebugSymbolGroup::GetSymbolOffset, а также значение поля Offset в структуре DEBUG_SYMBOL_ENTRY.

[in] Flags

Задает битовый флаг, который изменяет поведение этого метода. Если битовое DEBUG_GETFNENT_RAW_ENTRY_ONLY не задано, подсистема предоставит искусственные записи для хорошо известных случаев. Если этот бит задан, искусственные записи не используются.

[out, optional] Buffer

Получает сведения о записи функции. Если эффективный процессор является x86, это FPO_DATA структура для функции. Для всех остальных архитектур это IMAGE_FUNCTION_ENTRY структура для этой архитектуры.

[in] BufferSize

Задает размер буфера буфера.

[out, optional] BufferNeeded

Задает размер сведений о записи функции.

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

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Возвращаемый код Описание
S_OK
Метод был успешным.
S_FALSE
Метод был успешным, но буфер был недостаточно велик для хранения сведений о записи функции и поэтому информация была усечена для соответствия.
E_NOINTERFACE
Сведения о записи функции не найдены для расположения смещения.

Замечания

Структуры FPO_DATA и IMAGE_FUNCTION_ENTRY описаны в разделе "Библиотека справки по образам", которая включена в средства отладки для Windows в файле DbgHelp.chm.

Примечание Функции в библиотеке справки по изображениям и библиотеке справки отладки, документируемой в DbgHelp.chm, не должны вызываться любым приложением модуля расширения или обработчика отладчика.
 
Дополнительные сведения о символах см. в символов.

Требования

Требование Ценность
целевая платформа Настольный
заголовка dbgeng.h (include Dbgeng.h, Winnt.h)

См. также

DEBUG_SYMBOL_ENTRY

GetNextSymbolMatch

IDebugSymbolGroup::GetSymbolOffset

IDebugSymbols3