共用方式為

IUpdateSearcher：：BeginSearch 方法 (wuapi.h)

  • 發行項

開始執行異步搜尋更新。 搜尋會使用目前設定的搜尋選項。

語法

HRESULT BeginSearch(
  [in]  BSTR       criteria,
  [in]  IUnknown   *onCompleted,
  [in]  VARIANT    state,
  [out] ISearchJob **retval
);

參數

[in] criteria

指定搜尋準則的字串。

[in] onCompleted

當異步搜尋作業完成時呼叫的 ISearchCompletedCallback 介面。

[in] state

ISearchJob 介面的 AsyncState 屬性所傳回的呼叫端特定狀態。

[out] retval

ISearchJob 介面，表示目前可能擱置的作業。

呼叫端會將傳回的值傳遞至 EndSearch 方法，以完成搜尋作業。

傳回值

如果成功 ， 則傳回S_OK。 否則，傳回 COM 或 Windows 錯誤碼。

此方法也可以傳回下列錯誤碼。

傳回碼 Description
E_POINTER
 參數值無效或 NULL。
E_ACCESSDENIED
 這個方法無法從遠端電腦呼叫。

備註

如需搜尋準則語法的完整描述，請參閱 搜尋。

除了實作 ISearchCompletedCallback 介面，您也可以使用腳本，在自動化物件上使用 DISPID 0 實作任何標識符的回呼例程。 onCompleted 參數的類型為 IUnknown*。

當您在應用程式中使用任何異步 WUA API 時，您可能需要實作逾時機制。 如需如何執行異步 WUA 作業的詳細資訊，請參閱 異步 WUA 作業的指導方針。

規格需求

需求 值
最低支援的用戶端 Windows XP、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003、Windows 2000 Server 與 SP3 [僅限桌面應用程式]
目標平台 Windows
標頭 wuapi.h
程式庫 Wuguid.lib
Dll Wuapi.dll

另請參閱

IUpdateSearcher