共用方式為

IWSDiscoveryProvider：：SearchById 方法 (wsddisco.h)

  • 發行項

依裝置識別碼初始化 WS-Discovery 主機的搜尋。

語法

HRESULT SearchById(
  [in]           LPCWSTR pszId,
  [in, optional] LPCWSTR pszTag
);

參數

[in] pszId

所需探索提供者的裝置識別碼。

[in, optional] pszTag

此搜尋的選擇性識別碼標籤。 可為 Null。

傳回值

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

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

備註

SearchById 會在嘗試尋找先前已知的特定裝置時起始 WS-Discovery Resolve 。 pszId 會當做 Resolve 中的端點位址使用。 此呼叫可能會導致一或多個 新增 回呼。 如果在搜尋完成之前發出任何 新增 回呼，則會發出 SearchComplete 回呼;否則，將會發出 SearchFailed 回呼 。

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

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

規格需求

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

另請參閱

IWSDiscoveryProvider