Метод IDebugControl3::AddExtension (dbgeng.h)

Метод AddExtension загружает библиотеку расширений в подсистему отладчика.

Синтаксис

HRESULT AddExtension(
  [in]  PCSTR    Path,
  [in]  ULONG    Flags,
  [out] PULONG64 Handle
);

Параметры

[in] Path

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

[in] Flags

Задайте нулевое значение.

[out] Handle

Получает дескриптор загруженной библиотеки расширений.

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

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

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

Комментарии

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

Библиотека расширений загружается в подсистему узла, а path содержит путь и имя файла для этого экземпляра обработчика отладчика.

AddExtension не завершает процесс загрузки и инициализации библиотеки DLL расширения. Чтобы сделать расширение доступным для использования, выполните последующий вызов GetExtensionFunction.

Дополнительные сведения об использовании библиотек расширений см. в разделе Вызов расширений и функций расширений.

Требования

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

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

GetExtensionFunction.

GetExtensionByPath

IDebugControl

IDebugControl2

IDebugControl3

RemoveExtension