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

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

The server MUST perform the following:•Create a new async object implementing the IVdsAsync interface with an output type of<strong>VDS</strong>_ASYNCOUT_REMOVEVOLUMEPLEX and set the pointer that ppAsync references to theinterface.•If the volume resides on a basic disk, the server MUST return <strong>VDS</strong>_E_NOT_SUPPORTED(HRESULT of 0x80042400).•Return an HRESULT indicating failure or success. Any errors encountered up through this point inprocessing the operation are returned in this HRESULT.The server MUST then perform the following in sequence. Errors generated in this sequence of stepsare returned in the pHrResult parameter to the IVdsAsync::Wait or IVdsAsyncQueryStatus methods.•Remove the volume plex that corresponds to the <strong>VDS</strong>_OBJECT_ID PlexId specifies from thisvolume.•Remove the corresponding volume plex object from the list of storage management objects.•Set the return code in the async object to an HRESULT indicating failure or success.•If the task completed successfully, set the percentage completed value in the async object to100.•Set the signal state in the async object to TRUE.The server MUST update the percentage completed value periodically during the precedingsequence. How often the percentage completed is updated, and at what point in the sequence, isimplementation-specific.3.4.5.2.30.9 IVdsVolume::Delete (Opnum 11)The Delete method deletes all plexes in a volume.HRESULT Delete([in] long bForce);bForce: A Boolean that determines whether all plexes in a volume are deleted when the volumeis in use.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.ERROR_SUCCESS (0x00000000)When the server receives this message, it MUST perform the following:•Attempt to get exclusive access to the volume. If the server fails to get exclusive access to thevolume, and the bForce parameter is not set to true, then the server MUST return<strong>VDS</strong>_E_DEVICE_IN_USE.[<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, 2011243 / 360

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

Saved successfully!

Ooh no, something went wrong!