共用方式為

IWSDiscoveryProviderNotify：：SearchFailed 方法 (wsddisco.h)

  • 發行項

呼叫 以指出使用者起始的搜尋失敗。

語法

HRESULT SearchFailed(
  [in]           HRESULT hr,
  [in, optional] LPCWSTR pszTag
);

參數

[in] hr

起始此回呼的搜尋失敗原因。 值S_FALSE表示搜尋已完成，而不發出任何新增回呼。

[in, optional] pszTag

此搜尋的選擇性標識符標籤。 可能是 NULL。

傳回值

傳回值沒有意義。 實作者應該 傳回S_OK。

備註

如果成功收到任何回應，則會呼叫 SearchComplete。

如果使用者起始的查詢不會產生回應，則會呼叫 SearchFailed。 在此情況下， hr 參數的值將會S_FALSE。 如果嘗試傳輸查詢時發生錯誤，可以選擇性地呼叫 SearchFailed，因為查詢傳輸不一定是同步的。 pszTag 會比對來自查詢的使用者提供的標籤，而且應該用來識別哪個查詢失敗。

使用 SearchByType 或 SearchById 起始搜尋和接收 SearchFailed 通知之間的間隔上限為 10 秒，根據 WS-Discovery 的MATCH_TIMEOUT，並由 DPWS 附錄 I 修改。使用 SearchByAddress 起始搜尋和接收 SearchFailed 通知之間的間隔通常是 21 秒，但最多可以是 150 秒。

注意 提供者可能會對 SearchFailed 進行多個同時呼叫，因此必須在此回呼中同步處理共享數據。
 

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wsddisco.h (包含 Wsdapi.h)
Dll Wsdapi.dll

另請參閱

IWSDiscoveryProviderNotify