IDebugControl3：：GetExtensionFunction 方法 (dbgeng.h)

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	方法成功。

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

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

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

要求	值
目标平台	桌面
标头	dbgeng.h (包括 Dbgeng.h)