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

Force: A Boolean that determines whether the partition deletion is forced. If this parameter isset to a nonzero value, calls to lock and dismount any file system on the partition that fail areignored. If this parameter is set to zero and any file systems on the partition failed to belocked or dismounted, the server returns VDS_E_DEVICE_IN_USE.bForceProtected: A Boolean value that determines whether deletion of a protected partitionwill be forced.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 Creating or deleting partitions on dynamic disks is not supported.Note This method is not valid for CD/DVD or super floppy devices. These devices do notsupport partition tables.ERROR_SUCCESS (0x00000000)When the server receives this message, it MUST perform the following:•Attempt to get exclusive access to the partition. If the server fails to get exclusive access to thepartition, and the bForce parameter is not set to a non-zero value, then the server MUST returnVDS_E_DEVICE_IN_USE.•Delete the partition following the parameters specified to the method.•If deleting the partition removed a volume, remove the corresponding volume object from the listof storage management objects. For each callback object that is registered in the list of callbackobjects, call the callback object's IVdsAdviseSink::OnNotify method by using aVDS_NOTIFICATION structure that has the following attributes:•objectType member is VDS_NTT_VOLUME.•Volume member is a VDS_VOLUME_NOTIFICATION that has the following attributes:•ulEvent is VDS_NF_VOLUME_DEPART.•volumeId is the VDS_OBJECT_ID of the volume object that was removed.•For each callback object that is registered in the list of callback objects, call the callback object'sIVdsAdviseSink::OnNotify method by using a VDS_NOTIFICATION structure that has thefollowing attributes:•objectType member is VDS_NTT_PARTITION.•Partition member is a VDS_PARTITION_NOTIFICATION that has the following attributes:•ulEvent is VDS_NF_PARTITION_DEPART.•diskId is the VDS_OBJECT_ID of the disk object corresponding to the disk from which thepartition was deleted.•ullOffset is the byte offset at which the partition started on the disk.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011215 / 360