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

  • Статья

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

Синтаксис

HRESULT AddSyntheticModule(
  [in] ULONG64 Base,
  [in] ULONG   Size,
  [in] PCSTR   ImagePath,
  [in] PCSTR   ModuleName,
  [in] ULONG   Flags
);

Параметры

[in] Base

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

[in] Size

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

[in] ImagePath

Указывает имя образа искусственного модуля. Это имя, которое будет возвращено в качестве имени исполняемого файла для искусственного модуля. Если он известен, следует включить полный путь.

[in] ModuleName

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

[in] Flags

Задайте значение DEBUG_ADDSYNTHMOD_DEFAULT.

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

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

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

Комментарии

Область памяти искусственного модуля, описанная параметрами Base и Size , не должна перекрывать область памяти любого другого модуля.

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

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

AddSyntheticSymbol

IDebugSymbols3

RemoveSyntheticModule