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 错误代码。

此方法还可以返回以下错误代码。

返回代码	说明
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
Library	Wuguid.lib
DLL	Wuapi.dll