Метод IDebugSymbols2::GetNameByOffset (dbgeng.h)

Метод GetNameByOffset возвращает имя символа в указанном расположении в виртуальном адресном пространстве целевого объекта.

Синтаксис

HRESULT GetNameByOffset(
  [in]            ULONG64  Offset,
  [out, optional] PSTR     NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Displacement
);

Параметры

[in] Offset

Указывает расположение в виртуальном адресном пространстве целевого объекта символа, имя которого запрашивается. смещение не требуется указывать базовое расположение символа; Он должен указывать только расположение в выделении памяти символа.

[out, optional] NameBuffer

Получает имя символа. Имя квалифицируется модулем, к которому принадлежит символ (например, mymodule!main). Если NameBufferNULL, эти сведения не возвращаются.

[in] NameBufferSize

Задает размер символов буфера NameBuffer. Этот размер включает пробел для завершающего символа \0.

[out, optional] NameSize

Получает размер в символах имени символа. Этот размер включает пробел для завершающего символа \0. Если NameSizeNULL, эти сведения не возвращаются.

[out, optional] Displacement

Получает разницу между значением Offset и базовым расположением символа. Если смещениеnull, эти сведения не возвращаются.

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

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

Замечания

Дополнительные сведения о символах и именах символов см. в символов.

Требования

См. также

GetNearNameByOffset

GetOffsetByName

IDebugSymbols

IDebugSymbols2

IDebugSymbols3