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.

ProviderSpecificFlags: A bitmask of flags that are specific to the type of virtual disk that isbeing surfaced. These flags are provider-specific.TimeoutInMs: The length of time, in milliseconds, before this method should return afterwaiting for the virtual disk to be surfaced completely. If this parameter is zero, the methodreturns immediately without waiting for the disk to be surfaced. If this parameter is INFINITE,the method does not return until the surfacing operation is complete. If this parameter is setto a value other than zero or INFINITE and the time-out value is reached, the methodguarantees that the disk is not surfaced after the operation is complete.ppAsync: A pointer to an IVdsAsync (section 3.1.3.1) interface that, if the operation issuccessfully completed, receives the IVdsAsync interface to monitor and control thisoperation. Callers MUST release the interface when they are done with it.Return Values: This method MUST return zero to indicate success, or return an implementationspecificnonzero error code to indicate failure.When the server receives this message, it MUST validate the following parameters:•Verify that ppAsync is not NULL.The server MUST perform the following:•Create a new async object implementing the IVdsAsync interface with an output type of<strong>VDS</strong>_ASYNCOUT_ATTACH_VDISK and set the pointer ppAsync to the interface.•Return an HRESULT indicating failure or success. Any errors encountered up through this pointin processing 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.•Pass the input parameters to the operating system to attach the virtual disk.•Set the return code in the async object to an HRESULT indicating failure or success of theoperating system. If the task completed successfully, set the percentage-completed value in theasync object to 100.•Set the signal state in the async object to TRUE.At any point in the preceding sequence, before the percentage-completed value in the async objectis 100, the server MUST update the percentage-completed value if forward progress is made duringthe compact operation.3.4.5.2.39.2 IVdsOpenV<strong>Disk</strong>::Detach (Opnum 4)The Detach method removes the operating system disk device that represents a virtual disk.HRESULT Detach([in] DETACH_VIRTUAL_DISK_FLAG Flags,[in] ULONG ProviderSpecificFlags);Flags: A DETACH_VIRTUAL_DISK_FLAG (section 2.2.2.19.1.2) enumeration value thatspecifies how the virtual disk is to be detached.[<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, 2011271 / 360

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

Saved successfully!

Ooh no, something went wrong!