PDEBUG_EXTENSION_CALL回呼函式（dbgeng.h）

引擎會呼叫類型 PDEBUG_EXTENSION_CALL 的回呼函式，以執行擴充命令。只要函式未包含大寫字母，就可以為這些函式提供任何您想要的名稱。

語法

PDEBUG_EXTENSION_CALL PdebugExtensionCall;

HRESULT PdebugExtensionCall(
  [in]           PDEBUG_CLIENT Client,
  [in, optional] PCSTR Args
)
{...}

[in] Client

指定客戶端的介面指標。這可用來與引擎互動。一般而言，這是發出擴充功能命令的用戶端。

[in, optional] Args

指定傳遞至延伸模組命令的自變數。特別是，如果從命令行呼叫擴充功能命令，Args 包含命令行的其餘部分。它可以 NULL 或空白。

傳回碼	描述
S_OK	函式成功。
DEBUG_EXTENSION_CONTINUE_SEARCH	表示函式無法處理命令，或是其他擴充 DLL 中相同命令的其他實作也應該執行。引擎應該繼續搜尋其他擴充 DLL 以取得另一個函式來處理命令。例如，如果每一個函式傳回CONTINUE_SEARCH，這可以用來讓所有說明函式執行。

引擎會忽略所有其他傳回值。

函式的名稱會成為擴充命令的名稱。執行擴充功能命令時，引擎會接著搜尋每個載入的延伸模組 DLL，尋找與命令同名的導出函式。例如，執行命令 ！stack時，引擎會在每個載入的擴充 DLL 中尋找名為堆疊的導出函式。如需搜尋擴充功能 DLL 順序的相關信息，請參閱使用除錯程式擴充功能命令。

延伸模組函式應該使用在用戶端 用戶端 中傳遞給它的用戶端，以便與引擎進行所有互動，除非它有使用另一個用戶端的特定原因。擴充函式在完成之後，不應該維護客戶端物件的指標。

DebugExtensionCall 在 Dbgeng.h 頭文件中稱為 PDEBUG_EXTENSION_CALL。

要求	價值
目標平臺	桌面
標頭	dbgeng.h