3.8.4.1 ICategoryCollection::Item (Opnum 8)

  • Article

The ICategoryCollection::Item (opnum 8) method retrieves an item by index.

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

index: The zero-indexed position of the item to retrieve.

retval: The ICategory 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 in the List ADM element at the given index.