IWSDiscoveryProvider：：SearchByAddress 方法 (wsddisco.h)

  • 發行項

依裝置位址初始化 WS-Discovery 主機的搜尋。

語法

HRESULT SearchByAddress(
  [in]           LPCWSTR pszAddress,
  [in, optional] LPCWSTR pszTag
);

參數

[in] pszAddress

裝置的 HTTP 傳輸位址。

[in, optional] pszTag

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

傳回值

可能的傳回值包括，但不限於下列各項：

傳回碼 描述
S_OK
 方法已順利完成。
E_INVALIDARG
 pszAddress 為 NULL、 pszAddress 的字元長度超過 WSD_MAX_TEXT_LENGTH (8192) ，或 pszTag 字元中的長度超過 WSD_MAX_TEXT_LENGTH (8192) 。
E_ABORT
 尚未附加回呼介面。 您必須先呼叫 Attach ，才能呼叫此方法。
E_OUTOFMEMORY
 記憶體不足，無法執行作業。

備註

SearchByAddress 會在嘗試識別位於已知 URL 的裝置時，透過 HTTP 起始 WS-Discovery 探查 。 探查會傳送至 pszAddress 所指定的位址。 此呼叫可能會導致一或多個 新增 回呼。 如果在搜尋完成之前發出任何 「新增 回呼」，將會發出 SearchComplete 回呼;否則，將會發出 SearchFailed 回呼。 起始搜尋和接收其中一個通知之間的間隔最多可以是30秒。

pszTag 是選擇性使用者提供的字串，會在任一回呼中傳回，讓呼叫端將回呼與原始查詢產生關聯。

如需針對呼叫此方法的應用程式進行疑難解答的詳細資訊，請參閱 針對WSDAPI 應用程式進行疑難解答。

規格需求

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

另請參閱

IWSDiscoveryProvider