IFunctionDiscoveryNotification：：OnError 方法 (functiondiscoveryapi.h)

[函式探索可用於需求一節中指定的作業系統。後續版本可能會變更或無法使用。]

接收異步查詢處理期間發生的錯誤。

語法

HRESULT OnError(
  [in] HRESULT        hr,
  [in] FDQUERYCONTEXT fdqcQueryContext,
  [in] const WCHAR    *pszProvider
);

[in] hr

正在報告的查詢錯誤。

[in] fdqcQueryContext

註冊變更通知的內容。 FDQUERYCONTEXT 類型定義為 DWORDLONG。

[in] pszProvider

提供者的名稱。

用戶端程式的 OnError 方法實作應該會將下列其中一個 HRESULT 值傳回給呼叫端。

傳回碼	描述
S_OK	已成功完成命令。
E_INVALIDARG	其中一個輸入參數的值無效。

一般而言，用戶端會預期任何異步錯誤都嚴重，而且查詢會停止傳回結果，但自定義提供者檔可能會指出特定錯誤碼的其他原因。

請勿從這個方法對查詢物件呼叫 Release 。這樣做可能會導致死結。如果在處理回呼時，從另一個線程呼叫 Release ，則直到回呼完成之後，才會釋放物件。

由提供者傳遞至函式探索的所有通知都會排入佇列，並逐一傳回給用戶端。回呼會同步處理，因此用戶端一次只會收到一個通知。

因為其他 IFunctionDiscoveryNotification 方法呼叫可能會在其他線程中進行，所以必須在呼叫期間還原對線程狀態所做的任何變更，才能結束方法。

此頁面對您有幫助嗎？