[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification

When the server receives this message, it MUST perform the following:•If the number of objects from the current index to the end of the enumeration is greater than orequal to the number in celt, increment the current index by celt and return an HRESULT thatindicates failure or success.•If the number of objects from the current index to the end of the enumeration is less than thenumber of objects that celt requested, increment the current index by the number of objectsfrom the current index to the end of the enumeration and return S_FALSE (HRESULT of0x00000001) if successful.•If the current index is already past the list of objects in the enumeration, return S_FALSE(HRESULT of 0x00000001) if successful.3.4.5.2.1.3 IEnumVdsObject::Reset (Opnum 5)The Reset method resets the enumerator to the beginning of the collection.[helpstring("method Reset")] HRESULT Reset();This method has no parameters.Return Values: The method MUST return zero or a non-error HRESULT (as specified in [MS-ERREF]) to indicate success or return an implementation-specific nonzero error code toindicate failure. For the HRESULT values predefined by the Virtual Disk Service RemoteProtocol, see section 2.2.3.When the server receives this message, it MUST set the current index to the beginning of theenumeration and return an HRESULT that indicates failure or success.3.4.5.2.1.4 IEnumVdsObject::Clone (Opnum 6)The Clone method creates a new enumeration that has the same state as the current enumeration.[helpstring("method Clone")] HRESULT Clone([out] IEnumVdsObject** ppEnum);ppEnum: A pointer to an IEnumVdsObject interface that, if successfully completed, receivesthe IEnumVdsObject interface of the cloned enumeration. Callers MUST release the interfacethat is received when they are done with it.Return Values: The method MUST return zero or a non-error HRESULT (as specified in [MS-ERREF]) to indicate success or return an implementation-specific nonzero error code toindicate failure. For the HRESULT values predefined by the Virtual Disk Service RemoteProtocol, see section 2.2.3.When the server receives this message, it MUST validate the parameter:•Verify that ppEnum is not NULL.The server MUST perform the following:•Create a new enumeration object that implements the IEnumVdsObject interface. Then set thepointer that ppEnum references to the interface.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011169 / 360