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.

•For each callback object that is registered in the list of callback objects, call the callback object'sIVdsAdviseSink::OnNotify() method by using a <strong>VDS</strong>_NOTIFICATION structure that has thefollowing attributes:•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 systems 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.34 IVdsVolumeMF3 Methods3.4.5.2.34.1 IVdsVolumeMF3::QueryVolumeGuidPathnames (Opnum 3)The QueryVolumeGuidPathnames method returns a volume's volume GUID path names.HRESULT QueryVolumeGuidPathnames([out, string, size_is(,*pulNumberOfPaths)]LPWSTR** pwszPathArray,[out] ULONG* pulNumberOfPaths);pwszPathArray: Returns an array of null-terminated Unicode strings; one string for eachvolume GUID path name associated with the volume.pulNumberOfPaths: Returns the number of volume GUID path names returned inpwszPathArray.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 pwszPathArray is not NULL.•Verify that pulNumberOfPaths is not NULL.The server MUST then perform the following:[<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, 2011259 / 360

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

Saved successfully!

Ooh no, something went wrong!