3.16.4.1 IUpdateSession::ClientApplicationID (Opnum 8)

The IUpdateSession::ClientApplicationID (opnum 8) method retrieves the identifier of the calling application.

 HRESULT ClientApplicationID(
   [out, retval] BSTR* retval
 );

retval: The identifier of the calling application previously set using the IUpdateSession::ClientApplicationID (opnum 9) (section 3.16.4.2) method. If no identifier was previously set, this MUST be NULL or the empty string.

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 return the value of the ClientApplicationID ADM element.