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.

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.•Format the volume following the parameters specified to the method.•For each callback object registered in the list of callback objects, call the callback object'sIVdsAdviseSink::OnNotify() method with a <strong>VDS</strong>_NOTIFICATION structure with the followingattributes:•objectType member is <strong>VDS</strong>_NTT_VOLUME.•Volume member is a <strong>VDS</strong>_VOLUME_NOTIFICATION with the following attributes:•ulEvent is <strong>VDS</strong>_NF_VOLUME_MODIFY.•volumeId is the <strong>VDS</strong>_OBJECT_ID of this volume object.•If TRUE is specified for bEnableCompression and the file system being formatted supportscompression, compress the file system after formatting is complete.•Set the return code in the async object to an HRESULT indicating failure or success.•If the server tried to compress the file system after formatting but failed, the return codeMUST be set to <strong>VDS</strong>_S_VOLUME_COMPRESS_FAILED (HRESULT of 0x00042443).•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.3.4.5.2.32.3 IVdsVolumeMF::AddAccessPath (Opnum 5)The AddAccessPath method adds an access path to the current volume.HRESULT AddAccessPath([in, max_is(MAX_PATH - 1), string]WCHAR* pwszPath);pwszPath: A null-terminated Unicode string that indicates the access path. A trailing backslashMUST be included if the access path is a drive letter (for example, "F:\").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 parameter:•Verify that pwszPath is not NULL.The server MUST then perform the following in sequence:•Add the access path to the volume.•If the server determines that a mounted folder path name was added to the volume, for eachcallback object that is registered in the list of callback objects, the server MUST call the callback[<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, 2011250 / 360

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

Saved successfully!

Ooh no, something went wrong!