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

•objectType member is VDS_NTT_PARTITION.•Partition member is a VDS_PARTITION_NOTIFICATION that has the following attributes:•ulEvent is VDS_NF_PARTITION_MODIFY.•diskId is the VDS_OBJECT_ID of the disk object corresponding to the disk on which thepartition attribute was modified.•ullOffset is the byte offset where the partition started on the disk.•If attributes on the partition were successfully changed, and a volume exists on the partition, foreach callback object 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_VOLUME.•Volume member is a VDS_VOLUME_NOTIFICATION that has the following attributes:•ulEvent is VDS_NF_VOLUME_MODIFY.•volumeId is the VDS_OBJECT_ID of this volume object.•Return an HRESULT indicating failure or success.3.4.5.2.23.6 IVdsAdvancedDisk::AssignDriveLetter (Opnum 8)The AssignDriveLetter method assigns a drive letter to an existing OEM, ESP, or unknownpartition.HRESULT AssignDriveLetter([in] ULONGLONG ullOffset,[in] WCHAR wcLetter);ullOffset: The byte offset of the partition, from the beginning of the disk. This offset MUST bethe offset of a start of a partition.wcLetter: The drive letter to assign, as a single uppercase or lowercase alphabetical (A-Z)Unicode character.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.When the server receives this message, it MUST validate the following parameters:•Verify that the partition at the byte offset specified by ullOffset does not have a volume existingon it.•Verify that the drive letter specified by wcLetter is not already used.The server MUST assign the drive letter to the partition and return an HRESULT indicating failure orsuccess.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011217 / 360