Edit

IUpdateServiceManager::AddScanPackageService method (wuapi.h)

  • Article

Registers a scan package as a service with Windows Update Agent (WUA) and then returns an IUpdateService interface.

Syntax

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

Parameters

[in] serviceName

A descriptive name for the scan package service.

[in] scanFileLocation

The path of the Microsoft signed scan file that has to be registered as a service.

[in] flags

Determines how to remove the service registration of the scan package.

For possible values, see UpdateServiceOption.

[out] ppService

A pointer to an IUpdateService interface that contains service registration information.

Return value

Returns S_OK if successful. Otherwise, returns a COM or Windows error code. This method can also return the following error codes.

Return code Description
E_INVALIDARG
A parameter value is invalid.
E_ACCESSDENIED
 This method cannot be called from a remote computer.
WU_E_INVALID_OPERATION
 The computer could not access the update site.

Remarks

You can use the ID of the service in searches by passing the ID as the ServiceID property of the IUpdateSearcher interface.

To free resources, remove the service after it is no longer needed. Use the RemoveService method to remove the service.

Do not call the RegisterServiceWithAU method for the service that the AddScanPackageService method registers.

The service that is returned by AddScanPackageService is in the collection of services that the Services property of the IUpdateServiceManager interface returns. This service has the special IsScanPackageService property.

An error is returned by WinVerifyTrust if the Authorization Cab is not signed.

This method returns WU_E_INVALID_OPERATION if the object that implements the interface has been locked down.

Requirements

Requirement Value
Minimum supported client Windows XP, Windows 2000 Professional with SP3 [desktop apps only]
Minimum supported server Windows Server 2003, Windows 2000 Server with SP3 [desktop apps only]
Target Platform Windows
Header wuapi.h
Library Wuguid.lib
DLL Wuapi.dll

See also

IUpdateServiceManager