Поделиться через

Метод 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

Состояние вызывающего объекта, возвращаемое свойством AsyncState интерфейса ISearchJob .

[out] retval

Интерфейс ISearchJob , представляющий текущую операцию, которая может находиться в состоянии ожидания.

Вызывающий объект передает возвращаемое значение методу EndSearch для завершения операции поиска.

Возвращаемое значение

В случае успешного выполнения возвращает S_OK . В противном случае возвращает код ошибки COM или Windows.

Этот метод также может возвращать следующие коды ошибок.

Код возврата Описание
E_POINTER
 Недопустимое значение параметра или ЗНАЧЕНИЕ NULL.
E_ACCESSDENIED
 Этот метод нельзя вызвать с удаленного компьютера.

Комментарии

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

В качестве альтернативы реализации интерфейса ISearchCompletedCallback можно использовать скрипт для реализации процедуры обратного вызова любого идентификатора с DISPID 0 в объекте автоматизации. Тип параметра onCompleted — IUnknown*.

При использовании любого асинхронного API WUA в приложении может потребоваться реализовать механизм времени ожидания. Дополнительные сведения о выполнении асинхронных операций WUA см. в разделе Рекомендации по асинхронным операциям WUA.

Требования

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

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

IUpdateSearcher