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

efore the method call returns to the client, the method will return an error code and MAY not returnthe IVdsAsync interface.If the task fails after the method call has returned to the client but before the task has completed,the IVdsAsync interface will return an error code and MAY not contain any other information.3.4.5.2 Message Processing DetailsBefore processing the methods that are listed in the following sections, the server SHOULD obtainidentity and authorization information about the client from the underlying DCOM or RPC runtime.The server does this in order to verify that the client has sufficient permissions to create, modify, ordelete the object as appropriate. These methods SHOULD impose an authorization policy decisionbefore performing the function. The suggested minimum requirement is that the caller haspermission to create, modify, or delete the object as appropriate.If any method is called before the server returns success from either theIVdsService::IsServiceReady (Opnum 3) method or the IVdsService::WaitForServiceReady(Opnum 4) method, the VDS_E_INITIALIZED_FAILED value is returned.If parameter validation fails, the server MUST immediately fail the operation, returning a vendorspecificerror as its response to the client.3.4.5.2.1 IEnumVdsObject MethodsThe server MUST maintain the enumeration object until the client releases all references to theinterface.3.4.5.2.1.1 IEnumVdsObject::Next (Opnum 3)The Next method returns a specified number of objects in the enumeration. It begins from thecurrent point.[helpstring("method Next")] HRESULT Next([in] unsigned long celt,[out, size_is(celt), length_is(*pcFetched)]IUnknown** ppObjectArray,[out] unsigned long* pcFetched);celt: The number of elements to retrieve from the enumeration.ppObjectArray: A pointer to an array of IUnknown interfaces. The size of this array MUST beequal to celt. If successfully completed, it receives an array of the IUnknown interfaces of thenext objects in the enumeration; the number of elements in this array MUST be equal in sizeto the value of pcFetched. Callers MUST release each IUnknown interface that is received.pcFetched: A pointer to a variable that, upon successful completion, receives the number ofelements that are successfully received in ppObjectArray.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.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011167 / 360