3.22.4.6 IUpdateCollection::Add (Opnum 13)

  • Article

The IUpdateCollection::Add (opnum 13) method adds an item to the collection.

 HRESULT Add(
   [in] IUpdate* value,
   [out, retval] LONG* retval
 );

value: The item to add to the collection.

retval: The index of the added item.

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 the collection is read-only, 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 append the given item to the List ADM element and increment the value of the Count ADM element.