IWSDiscoveryProvider：：SearchByType 方法 (wsddisco.h)

依裝置類型初始化 WS-Discovery 主機的搜尋。

語法

HRESULT SearchByType(
  [in, optional] const WSD_NAME_LIST *pTypesList,
  [in, optional] const WSD_URI_LIST  *pScopesList,
  [in, optional] LPCWSTR             pszMatchBy,
  [in, optional] LPCWSTR             pszTag
);

參數

[in, optional] pTypesList

WSD_NAME_LIST 結構的指標，代表要搜尋的探索提供者類型清單。 可能是 NULL。

[in, optional] pScopesList

WSD_URI_LIST 結構的指標，代表要搜尋的探索提供者範圍清單。 可能是 NULL。

[in, optional] pszMatchBy

用於範圍的比對規則。 可能是 NULL。

[in, optional] pszTag

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

傳回值

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

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

備註

SearchByType 會在嘗試找出符合所提供準則的探索主機時，起始 WS-Discovery 探查 。 當未) 提供任何範圍或類型時，此方法允許依類型、範圍、兩者的某些組合，或比對所有探索功能裝置 (。

只有在也提供 pScopesList 時，才應該提供 pszMatchBy。 此呼叫可能會導致一或多個 新增 回呼。 如果在搜尋完成之前發出任何 「新增 回呼」，將會發出 SearchComplete 回呼;否則，將會發出 SearchFailed 回呼。

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

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

規格需求

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

另請參閱

IWSDiscoveryProvider