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

Статья
08/07/2023

Метод AddSyntheticSymbol добавляет искусственный символ в модуль в текущем процессе.

Синтаксис

HRESULT AddSyntheticSymbol(
  [in]            ULONG64              Offset,
  [in]            ULONG                Size,
  [in]            PCSTR                Name,
  [in]            ULONG                Flags,
  [out, optional] PDEBUG_MODULE_AND_ID Id
);

Параметры

[in] Offset

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

[in] Size

Задает размер искусственного символа в байтах.

[in] Name

Указывает имя искусственного символа.

[in] Flags

Задайте для значение DEBUG_ADDSYNTHSYM_DEFAULT.

[out, optional] Id

Получает структуру DEBUG_MODULE_AND_ID , которая идентифицирует искусственный символ. Если id имеет значение NULL, эта информация не возвращается.

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

Код возврата	Описание
S_OK	Метод выполнен успешно.

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

Если модуль, содержащий искусственный символ, перезагружается, например путем вызова Reload с параметром Module, для параметра Module задано имя модуля, искусственный символ будет удален.

Дополнительные сведения об искусственных символах см. в разделе Искусственные символы.