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

Статья
08/07/2023

Метод 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

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

[out, optional] NameBuffer

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

[in] NameBufferSize

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

[out, optional] NameSize

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

[out, optional] Displacement

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

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

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

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