[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification

);ulFlags: MUST be set to VDS_DF_READ_ONLY.Return Values: The method MUST return zero or a non-error HRESULT (as specified in [MS-ERREF]) to indicate success, or return an implementation-specific nonzero error code toindicate failure. For the HRESULT values predefined by the Virtual Disk Service RemoteProtocol, see section 2.2.3.Note This method is not valid for 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 VDS_DF_READ_ONLY.The server MUST perform the following in sequence:•Clear 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 VDS_NOTIFICATION structurethat has the following attributes:•objectType member is VDS_NTT_DISK.•Disk member is a VDS_DISK_NOTIFICATION that has the following attributes:•ulEvent is VDS_NF_DISK_MODIFY.•diskId is the VDS_OBJECT_ID of this disk object.•Return an HRESULT indicating failure or success.3.4.5.2.21 IVdsDisk2 Methods3.4.5.2.21.1 IVdsDisk2::SetSANMode (Opnum 3)The SetSANMode method sets the SAN mode of a disk to either offline or online. A disk that isoffline exposes no volume devices for partitions or volumes with extents on that disk. A disk may beREAONLY or READWRITE independent of the offline or online setting.HRESULT SetSANMode([in] long bEnable);bEnable: A Boolean value that indicates whether to set the disk to either online or offline.Return Values: The method MUST return zero or a non-error HRESULT (as specified in [MS-ERREF]) to indicate success, or return an implementation-specific nonzero error code toindicate failure. For the HRESULT values predefined by the Virtual Disk Service RemoteProtocol, see section 2.2.3.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011209 / 360