[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification
[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification
[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
this returned value as the id input parameter to the GetObject method. IVdsXXX::GetPropertiesreturns this value as the <strong>VDS</strong>_PROVIDER_PROP id member, <strong>VDS</strong>_PACK_PROP id member,<strong>VDS</strong>_DISK_PROP id member, <strong>VDS</strong>_VDISK_PROPERTIES Id member, <strong>VDS</strong>_VOLUME_PROP idmember, <strong>VDS</strong>_VOLUME_PLEX_PROP id member, or <strong>VDS</strong>_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.IVds<strong>Service</strong>::Advise: Prior to invoking Advise, the client callsIVds<strong>Service</strong>::WaitFor<strong>Service</strong>Ready or polls by using IVds<strong>Service</strong>::Is<strong>Service</strong>Readysuccessfully. The client invokes IVds<strong>Service</strong>::Advise to retrieve the client identification valueparameter. The client passes the client identification value as the dwCookie input parameter to theUnadvise method.IVds<strong>Service</strong>::Unadvise: Prior to invoking Unadvise, the client invokes IVds<strong>Service</strong>::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 invokesIVds<strong>Disk</strong>::GetProperties or IVds<strong>Disk</strong>3::GetProperties2 to retrieve the disk ID parameter. Theclient passes this returned value as the <strong>VDS</strong>_INPUT_DISK::diskId input parameter to theCreateVolume method. CreateVolume takes an array of one or more <strong>VDS</strong>_INPUT_DISKstructures, and IVds<strong>Disk</strong>::GetProperties or IVds<strong>Disk</strong>3::GetProperties2 is called once for eachdisk in this array. IVds<strong>Disk</strong>::GetProperties and IVds<strong>Disk</strong>3::GetProperties2 return this value asthe <strong>VDS</strong>_DISK_PROP::id or <strong>VDS</strong>_DISK_PROP2::id output parameter.IVdsPack::Add<strong>Disk</strong>: Prior to invoking Add<strong>Disk</strong>, the client invokes IVds<strong>Disk</strong>::GetProperties orIVds<strong>Disk</strong>3::GetProperties2 to retrieve the disk ID parameter. The client passes this returnedvalue as the <strong>Disk</strong>Id input parameter to the Add<strong>Disk</strong> method. IVds<strong>Disk</strong>::GetProperties andIVds<strong>Disk</strong>3::GetProperties2 return this value as the id output parameter.IVdsPack::Migrate<strong>Disk</strong>s: Prior to invoking Migrate<strong>Disk</strong>s, the client invokesIVds<strong>Disk</strong>::GetProperties for each disk in the input array, to retrieve the list of disk id parameters.The client passes this returned value as the p<strong>Disk</strong>Array input parameter to the Migrate<strong>Disk</strong>smethod. IVds<strong>Disk</strong>::GetProperties returns this value as the <strong>VDS</strong>_DISK_PROP::id outputparameter.Prior to invoking Migrate<strong>Disk</strong>s, the client invokes IVdsPack::GetProperties to retrieve the targetpack ID parameter. The client passes this returned value as the TargetPack input parameter to theMigrate<strong>Disk</strong>s method. IVdsPack::GetProperties returns this value as the <strong>VDS</strong>_PACK_PROP::idoutput parameter.IVdsPack::RemoveMissing<strong>Disk</strong>: Prior to invoking RemoveMissing<strong>Disk</strong>, the client invokesIVds<strong>Disk</strong>::GetProperties to retrieve the disk ID parameter. The client passes this returned valueas the <strong>Disk</strong>Id input parameter to the RemoveMissing<strong>Disk</strong> method. IVds<strong>Disk</strong>::GetProperties andIVds<strong>Disk</strong>3::GetProperties2 return this value as the <strong>VDS</strong>_DISK_PROP::id or<strong>VDS</strong>_DISK_PROP2::id output parameter.IVdsPack2::CreateVolume2: CreateVolume2 has the same call sequence description asIVdsPack::CreateVolume.[<strong>MS</strong>-<strong>VDS</strong>] — v20110610<strong>Virtual</strong> <strong>Disk</strong> <strong>Service</strong> (<strong>VDS</strong>) <strong>Protocol</strong> <strong>Specification</strong>Copyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011147 / 360