3.18.4.1 IStringCollection::Item (Opnum 8)

  • Article

The IStringCollection::Item (opnum 8) method gets an item by index.

 HRESULT Item(
   [in] LONG index,
   [out, retval] BSTR* retval
 );

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

retval: The string at the given index.

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 given index is less than 0x00000000 or greater than or equal to the number of items in the collection, the method MUST return an error.

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].

This method SHOULD return the item at the given index in the List ADM element.