3.44.4.4 IUpdateServiceManager::AddScanPackageService (Opnum 13)

  • Article

The IUpdateServiceManager::AddScanPackageService (opnum 13) method registers an update service based on a scan package.

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

serviceName: The name of the service.

scanFileLocation: The filesystem path of the scan package file.

flags: A bitmask produced from values from the UpdateServiceOption (section 2.2.14) enumeration value.

ppService: An IUpdateService instance representing a service based on the scan package.

Return Values: The method MUST return information in an HRESULT data structure. The severity bit in the structure identifies the following conditions:

  • If the severity bit is set to 0, the method completed successfully.

  • If the severity bit is set to 1, the method failed and encountered a fatal error.

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].

This method SHOULD trigger the update agent to add a service based on this scan package through an implementation-dependent<47> interface. This method SHOULD add the given service to the Services ADM element and return an IUpdateService instance representing the added service.