Метод IDebugSymbols::GetNearNameByOffset (dbgeng.h)

Метод GetNearNameByOffset возвращает имя символа, расположенного рядом с указанным расположением.

Синтаксис

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

Параметры

[in] Offset

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

[in] Delta

Указывает связь между нужным символом и символом, расположенным в Смещение. Если положительный результат, подсистема вернет символ, который символы Delta после символа, расположенного в Offset. Если отрицательный, подсистема вернет символ, который разностные символы перед символом, расположенным в Смещение.

[out, optional] NameBuffer

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

[in] NameBufferSize

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

[out, optional] NameSize

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

[out, optional] Displacement

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

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

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

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

Замечания

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

Если Delta равно нулю, эти методы ведут себя так же, как GetNameByOffset.

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

Требования

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

См. также

GetNameByOffset

GetOffsetByName

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

  • Last updated on