3.22.4.2 IUpdateCollection::Item (Opnum 9)

  • Article

The IUpdateCollection::Item (opnum 9) method replaces an item in the collection by index.

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

index: The zero-based index of the item to replace.

value: The item with which to replace the existing 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 index is less than 0x00000000 or greater than or equal to the number of items in the collection, the server MUST return an 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 set the given item at the given index in the List ADM element.