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)