3.38.4.2 IUpdateSearcher::CanAutomaticallyUpgradeService (Opnum 9)

  • Article

The IUpdateSearcher::CanAutomaticallyUpgradeService (opnum 9) method sets whether the update agent can automatically upgrade itself before performing a search initiated through this instance.

 HRESULT CanAutomaticallyUpgradeService(
   [in] VARIANT_BOOL value
 );

value: Set to VARIANT_TRUE to allow the update agent to automatically upgrade itself, if it is an older version, before performing a search through this instance; otherwise, set to VARIANT_FALSE to disallow automatic upgrading of the update agent.

Return Values: The method MUST return information 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 value is neither VARIANT_TRUE nor VARIANT_FALSE, this method MUST return an error.

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

This method SHOULD set the value of the CanAutomaticallyUpgradeService ADM element to the contents of the value parameter.