共用方式為


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
pszAddressNULLpszAddress 的字元長度超過 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