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

Статья
08/07/2023

Метод 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). Если NameBuffer имеет значение NULL, эти сведения не возвращаются.

[in] NameBufferSize

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

[out, optional] NameSize

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

[out, optional] Displacement

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

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
S_FALSE	Метод выполнен успешно. Однако буфер не был достаточно велик для хранения имени символа, поэтому он был усечен.
E_FAIL	Не удалось найти символ в указанном расположении.