13.07.2015 Views

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

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

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

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

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 ofvolume plex objects in the list of cached storage management objects that have their volumepointer set to this volume object, as specified in section 3.4.1.3. The server MUST then return anHRESULT indicating failure or success.3.4.5.2.30.4 IVdsVolume::Extend (Opnum 6)The Extend method expands the size of the current volume by adding disk extents to each memberof each plex.HRESULT Extend([in, unique, size_is(lNumberOf<strong>Disk</strong>s)]<strong>VDS</strong>_INPUT_DISK* pInput<strong>Disk</strong>Array,[in] long lNumberOf<strong>Disk</strong>s,[out] IVdsAsync** ppAsync);pInput<strong>Disk</strong>Array: A pointer to an array of <strong>VDS</strong>_INPUT_DISK structures that describe the diskextents to add to the volume--one structure for each disk. Callers SHOULD specify themember index for all the disk extents together with the Extend method, unless the volumehas only one plex with only one member.lNumberOf<strong>Disk</strong>s: The number of elements in pInput<strong>Disk</strong>Arrray.ppAsync: A pointer to an IVdsAsync interface that, if the operation is successfully completed,receives the IVdsAsync interface to monitor and control this operation. Callers MUST releasethe interface when they are done with it.Return Values: The method MUST return zero or a non-error HRESULT (as specified in [<strong>MS</strong>-ERREF]) to indicate success, or return an implementation-specific nonzero error code toindicate failure. For the HRESULT values predefined by the <strong>Virtual</strong> <strong>Disk</strong> <strong>Service</strong> Remote<strong>Protocol</strong>, see section 2.2.3.When the server receives this message, it MUST validate the following parameters:•Verify that pInput<strong>Disk</strong>Array is not NULL.•Verify that ppAsync is not NULL.The server MUST perform the following:•If the volume's file system does not support extend operations, then this method MUST return<strong>VDS</strong>_E_CANNOT_EXTEND. For example, on operating systems where both volumes are formattedwith the NTFS file system, volumes that have no file system formatting will return this error.•For each <strong>VDS</strong>_INPUT_DISK structure in the pInput<strong>Disk</strong>Array parameter, verify that the value ofthe ullSize field does not exceed the amount of free space on the given disk. If the volume isbeing created within a dynamic disk pack and if this requirement is not met, then the serverMUST return <strong>VDS</strong>_E_EXTENT_EXCEEDS_DISK_FREE_SPACE. If the volume is being createdwithin a basic disk pack and if this requirement is not met, then the server MUST return<strong>VDS</strong>_E_NOT_ENOUGH_SPACE.[<strong>MS</strong>-<strong>VDS</strong>] — v20110610<strong>Virtual</strong> <strong>Disk</strong> <strong>Service</strong> (<strong>VDS</strong>) <strong>Protocol</strong> <strong>Specification</strong>Copyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011237 / 360

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!