3.22.4.8 IUpdateCollection::Insert (Opnum 16)

  • Article

The IUpdateCollection::Insert (opnum 16) method inserts an item into the collection.

 HRESULT Insert(
   [in] LONG index,
   [in] IUpdate* value
 );

index: The zero-based position at which to insert the item. This can be a position at the end of the list.

value: The item to insert into the list.

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.

If index is less than 0x00000000 or greater than or equal to the number of items in the collection, 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 insert the given item at the given index in the List ADM element and increment the value of the Count ADM element.