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.

Clients cannot change the partitioning style on a disk with volumes. Clients cannot change thepartitioning style on a disk that contains the system, boot, pagefile, crashdump, or hibernationvolumes.If this method is called against a disk which contains volume or partition extents, then this methodMUST return <strong>VDS</strong>_E_DISK_NOT_EMPTY.3.4.5.2.20.6 IVds<strong>Disk</strong>::SetFlags (Opnum 8)The SetFlags method sets the read-only flag of a disk.HRESULT SetFlags([in] unsigned long ulFlags);ulFlags: MUST be set to <strong>VDS</strong>_DF_READ_ONLY.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.Note This method cannot be used against CD/DVD or super floppy devices.This method MUST return an HRESULT failure for OS boot disk, system disk, pagefile disk,hibernation file disk and crash dump disk.When the server receives this message, it MUST validate the following parameter:•Verify that the ulFlags parameter is <strong>VDS</strong>_DF_READ_ONLY.The server MUST perform the following in sequence:•Set the read-only attribute of the disk.•For each callback object that is registered in the list of callback objects, call the callback object'sIVdsAdviseSink::OnNotify (Opnum 3) method by using a <strong>VDS</strong>_NOTIFICATION structurethat has the following attributes:•objectType member is <strong>VDS</strong>_NTT_DISK.•<strong>Disk</strong> member is a <strong>VDS</strong>_DISK_NOTIFICATION that has the following attributes:•ulEvent is <strong>VDS</strong>_NF_DISK_MODIFY.•diskId is the <strong>VDS</strong>_OBJECT_ID of this disk object.•Return an HRESULT indicating failure or success.3.4.5.2.20.7 IVds<strong>Disk</strong>::ClearFlags (Opnum 9)The ClearFlags method clears the read-only flag of a disk.HRESULT ClearFlags([in] unsigned long ulFlags[<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, 2011208 / 360

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

Saved successfully!

Ooh no, something went wrong!