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

Метод IUpdateServiceManager::AddScanPackageService (wuapi.h)

  • Статья

Регистрирует пакет сканирования в качестве службы с помощью агента клиентский компонент Центра обновления Windows (WUA), а затем возвращает интерфейс IUpdateService.

Синтаксис

HRESULT AddScanPackageService(
  [in]  BSTR           serviceName,
  [in]  BSTR           scanFileLocation,
  [in]  LONG           flags,
  [out] IUpdateService **ppService
);

Параметры

[in] serviceName

Описательное имя службы пакета сканирования.

[in] scanFileLocation

Путь к подписанному корпорацией Майкрософт файлу сканирования, который необходимо зарегистрировать в качестве службы.

[in] flags

Определяет, как удалить регистрацию службы пакета сканирования.

Возможные значения см. в разделе UpdateServiceOption.

[out] ppService

Указатель на интерфейс IUpdateService , содержащий сведения о регистрации службы.

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

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

Код возврата Описание
E_INVALIDARG
Недопустимое значение параметра.
E_ACCESSDENIED
 Этот метод нельзя вызвать с удаленного компьютера.
WU_E_INVALID_OPERATION
 Компьютеру не удалось получить доступ к сайту обновления.

Комментарии

Идентификатор службы можно использовать в поисках, передав идентификатор в качестве свойства ServiceID интерфейса IUpdateSearcher .

Чтобы освободить ресурсы, удалите службу после того, как она больше не нужна. Используйте метод RemoveService , чтобы удалить службу.

Не вызывайте метод RegisterServiceWithAU для службы, которую регистрирует метод AddScanPackageService .

Служба, возвращаемая AddScanPackageService , находится в коллекции служб, возвращаемой свойством Services интерфейса IUpdateServiceManager. Эта служба имеет специальное свойство IsScanPackageService .

Если параметр Authorization Cab не подписан, winVerifyTrust возвращает ошибку.

Этот метод возвращает WU_E_INVALID_OPERATION , если объект, реализующий интерфейс, заблокирован.

Требования

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

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

IUpdateServiceManager