3.44.5.3 IUpdateServiceManager2::QueryServiceRegistration (Opnum 17)

  • Article

The IUpdateServiceManager2::QueryServiceRegistration (opnum 17) method retrieves the update service registration record for a service.

 HRESULT QueryServiceRegistration(
   [in] BSTR serviceID,
   [out, retval] IUpdateServiceRegistration** retval
 );

serviceID: A string identifying an update service.

retval: An IUpdateServiceRegistration (section 3.46.4) instance for the given service.

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.

If no service registration record is found for the given service ID, the server MUST return an error.

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

This method SHOULD return the service registration record for the identified service from the ServiceRegistrations ADM element.