IDebugControl：：GetExtensionFunction 方法（dbgeng.h）

GetExtensionFunction 方法从扩展库返回指向扩展函数的指针。

语法

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

[in] Handle

指定包含扩展函数的扩展库的句柄。如果句柄为零，则引擎将引导扩展库链搜索扩展函数。

[in] FuncName

指定要返回的扩展函数的名称。在搜索函数的扩展库时，调试器引擎将在名称前面追加“EFN”。例如，如果 FuncName 为“SampleFunction”，则引擎将搜索扩展库以获取“_EFN_SampleFunction”。

[out] Function

接收扩展函数。

此方法还可以返回错误值。有关详细信息，请参阅返回值。

返回代码	描述
S_OK	该方法成功。

扩展库加载到主机引擎中，无法远程调用扩展函数。当前客户端不能是调试客户端，它必须属于主机引擎。

扩展函数可以具有任何函数原型。为了使任何程序调用此扩展函数，扩展函数应转换为正确的原型。

有关使用扩展函数的详细信息，请参阅调用扩展和扩展函数。

要求	价值
目标平台	桌面
标头	dbgeng.h （包括 Dbgeng.h）