3.52.4.1 IWindowsUpdateAgentInfo::GetInfo (Opnum 8)

  • Article

The IWindowsUpdateAgentInfo::GetInfo (opnum 8) method retrieves version information for the server side of the protocol and the update agent.

 HRESULT GetInfo(
   [in] VARIANT varInfoIdentifier,
   [out, retval] VARIANT* retval
 );

varInfoIdentifier: A VARIANT ([MS-OAUT] section 2.2.29.2) containing a string specifying the type of version information to retrieve. The vt member of varInfoIdentifier MUST be set to VT_BSTR, and the BSTR ([MS-OAUT] section 2.2.23) stored in the bstrVal member MUST case-insensitively compare equal to one of the following values.

bstrVal value

Information to be retrieved

ApiMajorVersion

The major version number of the server side of the protocol.

ApiMinorVersion

The minor version number of the server side of the protocol.

ProductVersionString

The version of the update agent.

retval: A VARIANT containing the requested version information, as specified by the following table.

varInfoIdentifier.bstrVal value

retval

ApiMajorVersion

The vt member MUST be set to VT_I4. The lVal member SHOULD<52> be set to the server's major version.

ApiMinorVersion

The vt member MUST be set to VT_I4. The lVal member SHOULD<53> be set to the server's minor version.

ProductVersionString

The vt member MUST be set to VT_BSTR. The bstrVal member SHOULD<54> be set to the version of the update agent.

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].