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

Статья
02/06/2025

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

Синтаксис

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

Параметры

[in] Handle

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

[in] Function

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

[in, optional] Arguments

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

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

Возвращаемый код	Описание
S_OK	Метод был успешным.

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

Замечания

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

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