通过

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

另请参阅

IUpdateSearcher