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

lNumberOfDisks: The number of disks specified in pDiskArray.TargetPack: The VDS object ID of the pack object.bForce: A Boolean that determines whether disk migration is forced. When the client makes thecall to migrate disks, the provider(s) that owns the disks is notified by the server that thedisks are about to be migrated. The provider(s) can respond to this notification with an error.If this parameter is set to a nonzero value, the migration operation will continue. If theparameter is set to zero and the provider(s) owning the disks responds to the notification withan error, the call to migrate the disks will fail.bQueryOnly: A Boolean that determines whether the disk migration will actually happen.pResults: A pointer to an array of HRESULT values that, if the operation is successfullycompleted, receives the HRESULTs returned by each disk migration request. There MUST beone HRESULT value in the array for each disk in pDiskArray. If any of the disks fail to migrateproperly, the specific error code for that failure is received in the corresponding entry inpResults.pbRebootNeeded: A pointer to a Boolean that, if the operation is successfully completed,receives an indication of whether the user must reboot the remote machine in order tocomplete the migration process.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.The HRESULTs in the array that pResults references return zero to indicate success or animplementation-specific nonzero error code if the migration operation on the associated diskfails.ERROR_SUCCESS (0x00000000)When the server receives this message, it MUST validate the following parameters:•Verify that pDiskArray is not NULL.•Verify that pResults is not NULL.•Verify that pbRebootNeeded is not NULL.The server MUST perform the following:•If this method is called against a dynamic disk which contains volume extents, and the targetpack is a basic disk pack, then this method MUST return VDS_E_DISK_NOT_EMPTY.•For each VDS object identifier in the specified pDiskArray, migrate the disk that corresponds tothe identifier to this pack. Set the status of each migrate operation to the corresponding value inthe array that pResults specifies.•For each successfully migrated disk, set the disk object's pack pointer to this pack object.•If the disk migrations require a restart to take full effect, set the value of the Boolean thatpbRebootNeeded references to TRUE; otherwise, FALSE.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011201 / 360