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

this returned value as the id input parameter to the GetObject method. IVdsXXX::GetPropertiesreturns this value as the VDS_PROVIDER_PROP id member, VDS_PACK_PROP id member,VDS_DISK_PROP id member, VDS_VDISK_PROPERTIES Id member, VDS_VOLUME_PROP idmember, VDS_VOLUME_PLEX_PROP id member, or VDS_HBAPORT_PROP id member. Theclient can cache the object IDs for the lifetime of the object; it can later be used to retrieve aninterface to the object without having to cache the interface to the object itself, or having toenumerate and find the object every time it needs the object.IVdsService::Advise: Prior to invoking Advise, the client callsIVdsService::WaitForServiceReady or polls by using IVdsService::IsServiceReadysuccessfully. The client invokes IVdsService::Advise to retrieve the client identification valueparameter. The client passes the client identification value as the dwCookie input parameter to theUnadvise method.IVdsService::Unadvise: Prior to invoking Unadvise, the client invokes IVdsService::Advise toretrieve the client identification value. The client passes the client identification value as thedwCookie input parameter to the Unadvise method.3.2.1.3 PacksIVdsPack::CreateVolume: Prior to invoking CreateVolume, the client invokesIVdsDisk::GetProperties or IVdsDisk3::GetProperties2 to retrieve the disk ID parameter. Theclient passes this returned value as the VDS_INPUT_DISK::diskId input parameter to theCreateVolume method. CreateVolume takes an array of one or more VDS_INPUT_DISKstructures, and IVdsDisk::GetProperties or IVdsDisk3::GetProperties2 is called once for eachdisk in this array. IVdsDisk::GetProperties and IVdsDisk3::GetProperties2 return this value asthe VDS_DISK_PROP::id or VDS_DISK_PROP2::id output parameter.IVdsPack::AddDisk: Prior to invoking AddDisk, the client invokes IVdsDisk::GetProperties orIVdsDisk3::GetProperties2 to retrieve the disk ID parameter. The client passes this returnedvalue as the DiskId input parameter to the AddDisk method. IVdsDisk::GetProperties andIVdsDisk3::GetProperties2 return this value as the id output parameter.IVdsPack::MigrateDisks: Prior to invoking MigrateDisks, the client invokesIVdsDisk::GetProperties for each disk in the input array, to retrieve the list of disk id parameters.The client passes this returned value as the pDiskArray input parameter to the MigrateDisksmethod. IVdsDisk::GetProperties returns this value as the VDS_DISK_PROP::id outputparameter.Prior to invoking MigrateDisks, the client invokes IVdsPack::GetProperties to retrieve the targetpack ID parameter. The client passes this returned value as the TargetPack input parameter to theMigrateDisks method. IVdsPack::GetProperties returns this value as the VDS_PACK_PROP::idoutput parameter.IVdsPack::RemoveMissingDisk: Prior to invoking RemoveMissingDisk, the client invokesIVdsDisk::GetProperties to retrieve the disk ID parameter. The client passes this returned valueas the DiskId input parameter to the RemoveMissingDisk method. IVdsDisk::GetProperties andIVdsDisk3::GetProperties2 return this value as the VDS_DISK_PROP::id orVDS_DISK_PROP2::id output parameter.IVdsPack2::CreateVolume2: CreateVolume2 has the same call sequence description asIVdsPack::CreateVolume.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011147 / 360