Метод IDebugControl2::CallExtension (dbgeng.h)

Статья
02/23/2024

Метод CallExtension вызывает расширение отладчика.

Синтаксис

HRESULT CallExtension(
  [in]           ULONG64 Handle,
  [in]           PCSTR   Function,
  [in, optional] PCSTR   Arguments
);

Параметры

[in] Handle

Задает дескриптор библиотеки расширений, содержащей вызываемую функцию расширения. Если handle равен нулю, подсистема будет искать расширение по цепочке библиотек расширений.

[in] Function

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

[in, optional] Arguments

Указывает аргументы для передачи расширению. Аргументы — это строка, которая будет анализироваться расширением так же, как расширение будет анализировать аргументы, переданные ему при вызове в качестве команды расширения.

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

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

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

Если handle равно нулю, подсистема выполняет поиск каждой библиотеки расширений, пока не найдет ту, которая содержит расширение; затем будет вызываться расширение . Если расширение возвращает DEBUG_EXTENSION_CONTINUE_SEARCH, поиск продолжится.

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