IEnumNames::Reset method (comsvcs.h)
Resets the enumeration sequence to the beginning.
Syntax
HRESULT Reset();
Return value
This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following values.
Return code | Description |
---|---|
|
The enumeration sequence was reset. |
|
The enumeration sequence was reset, but there are no items in the enumerator. |
Remarks
You can use the S_FALSE return value as an optimization to detect an empty enumeration.
A call to this method, resetting the sequence, does not guarantee that the same set of objects will be enumerated after the reset, because the collection may have changed.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | comsvcs.h |