Метод IDebugControl::GetExtensionFunction (dbgeng.h)

Статья
07.08.2023

Метод GetExtensionFunction возвращает указатель на функцию расширения из библиотеки расширений.

Синтаксис

C++

HRESULT GetExtensionFunction(
  [in]  ULONG64 Handle,
  [in]  PCSTR   FuncName,
  [out] FARPROC *Function
);

Параметры

[in] Handle

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

[in] FuncName

Указывает имя возвращаемой функции расширения. При поиске функции в библиотеках расширений подсистема отладчика добавляет к имени значение EFN. Например, если funcName имеет значение SampleFunction, система будет искать в библиотеках расширений _EFN_SampleFunction.

[out] Function

Получает функцию расширения.

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

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

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

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

Функция расширения может иметь любой прототип функции. Чтобы любая программа вызывала эту функцию расширения, функция расширения должна быть приведена к правильному прототипу.

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