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

When the server receives this message, it MUST validate the following parameter:•Verify that pServiceProp is not NULL.The server MUST populate the VDS_SERVICE_PROP structure that pServiceProp references withthe properties of the server and return an HRESULT that indicates failure or success.3.4.5.2.4.4 IVdsService::QueryProviders (Opnum 6)The QueryProviders method enumerates the providers of the server.HRESULT QueryProviders([in] DWORD masks,[out] IEnumVdsObject** ppEnum);masks: The combination of any values, by using a bitwise OR operator, that theVDS_QUERY_PROVIDER_FLAG enumeration defines. The values that are set in the maskspecify the types of providers to return.ppEnum: A pointer to an IEnumVdsObject interface that, if successfully completed, receivesthe IEnumVdsObject interface of the object that contains an enumeration of provider objectson the server. Callers MUST release the interface that 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 following parameter:•Verify that ppEnum is not NULL.The server MUST point ppEnum to an IEnumVdsObject interface that contains the enumeration ofprovider objects in the list of cached storage management objects, as specified in section 3.4.1.3,and return an HRESULT that indicates failure or success.3.4.5.2.4.5 IVdsService::QueryUnallocatedDisks (Opnum 8)The QueryUnallocatedDisks method enumerates the unallocated disks on the server.HRESULT QueryUnallocatedDisks([out] IEnumVdsObject** ppEnum);ppEnum: A pointer to an IEnumVdsObject interface that, if the operation is successfullycompleted, receives the IEnumVdsObject interface of the object that contains anenumeration of disk objects that correspond to unallocated disks on the server. Callers MUSTrelease the interface that 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.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011174 / 360