iUpdateSession3::QueryHistory 方法 (wuapi.h)

同步查询计算机中的更新事件历史记录。 此方法返回指向包含计算机上匹配事件记录的 IUpdateHistoryEntryCollection 接口的指针。

语法

HRESULT QueryHistory(
  [in]  BSTR                          criteria,
  [in]  LONG                          startIndex,
  [in]  LONG                          count,
  [out] IUpdateHistoryEntryCollection **retval
);

参数

[in] criteria

一个指定搜索条件的字符串。

[in] startIndex

要检索的第一个事件的索引。

[in] count

要检索的事件数。

[out] retval

指向 IUpdateHistoryEntryCollection 接口的 指针,该接口包含计算机上按时间顺序降序排列的匹配事件记录。

返回值

如果成功 则返回S_OK。 否则,将返回 COM 或 Windows 错误代码。

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

返回代码 说明
E_POINTER
参数值无效或 为 NULL
WU_E_INVALID_CRITERIA
搜索条件无效。

注解

返回的事件集合按日期降序排序。

用于 criteria 参数的字符串必须与 QueryHistory 的自定义搜索语言匹配。 字符串包含条件,评估这些条件以确定要返回的历史记录事件。

请注意, QueryHistory 仅支持每台计算机更新。

有关搜索条件语法的完整说明,请参阅 搜索

下表按评估优先级顺序标识了所有公共支持条件。 将来可能会向此列表添加更多条件。

条件 类型 允许的操作 说明
UpdateID 字符串 (UUID) = 查找具有指定值的 UpdateIdentity.UpdateID 的更新。

例如,“UpdateID='12345678-9abc-def0-1234-56789abcdef0'”查找等于 12345678-9abc-def0-1234-56789abcdef0 的 UpdateId 的 更新。

要求

   
最低受支持的客户端 Windows XP、Windows 2000 Professional SP3 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003、Windows 2000 Server SP3 [仅限桌面应用]
目标平台 Windows
标头 wuapi.h
Library Wuguid.lib
DLL Wuapi.dll

另请参阅

IUpdateSession3