Метод 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
 Существуют недопустимые условия поиска.

Комментарии

Коллекция возвращаемых событий сортируется по дате в порядке убывания.

Строка, используемая для параметра условия, должна соответствовать языку пользовательского поиска для QueryHistory. Строка содержит критерии, которые оцениваются для определения возвращаемых событий журнала.

Обратите внимание, что QueryHistory поддерживает обновления только для каждого компьютера.

Полное описание синтаксиса условий поиска см. в разделе Поиск.

В следующей таблице указаны все критерии общедоступной поддержки в порядке приоритета оценки. В будущем в этот список могут быть добавлены дополнительные критерии.

Критерий Тип Допустимые операторы Описание
UpdateID string(UUID) = Находит обновления с заданным значением UpdateIdentity.UpdateID .

Например, "UpdateID='12345678-9abc-def0-1234-56789abcdef0'" находит обновления для UpdateIdentity.UpdateID , равные 12345678-9abc-def0-1234-56789abcdef0.

Требования

   
Минимальная версия клиента Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения]
Целевая платформа Windows
Header wuapi.h
Библиотека Wuguid.lib
DLL Wuapi.dll

См. также раздел

IUpdateSession3