IDebugControl：：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)