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

Статья
08/07/2023

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

Синтаксис

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	Метод выполнен успешно.

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

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

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