Share via

3.1.4.5.3 Reset (Opnum 5)

  • Article

The Reset method resets the enumerator back to the first element in the collection.

 [id(4), helpstring("method Reset")] HRESULT Reset();

This method has no parameters.

Return Values: An HRESULT specifying success or failure. All success codes other than S_FALSE MUST be treated the same, and all failure codes MUST be treated the same.

Return value/code

Description

0x00000001

S_FALSE

The enumeration sequence was reset, but there are no items in the enumerator.

When this method is invoked, the server MUST attempt to reset the enumerator back to the first element in the collection, and fail the call, returning a failure HRESULT back to the client if it cannot. If there are no elements in this collection, the function MUST return a success.