CHAPTER 4 Operations on Virtual Machines
73
RC1
VixVM_UpgradeVirtualHardware
Function Signature
VixHandle
VixVM_UpgradeVirtualHardware(VixHandle vmHandle,
unsigned int options,
VixEventProc *callbackProc,
void *clientData);
Parameters
Results
VixHandle — A job handle that describes the state of this asynchronous operation.
Notes
• Upgrades the virtual hardware version of the virtual machine to match the
version of the Vix library. This has no effect if the virtual machine is already at the
same version or at a newer version than the Vix library.
• The virtual machine must be powered off to do this operation.
Example
VixError err = VIX_OK;
VixHandle hostHandle = VIX_INVALID_HANDLE;
VixHandle jobHandle = VIX_INVALID_HANDLE;
VixHandle vmHandle = VIX_INVALID_HANDLE;
jobHandle = VixHost_Connect(VIX_API_VERSION,
VIX_SERVICEPROVIDER_VMWARE_SERVER,
NULL, // hostName
0, // hostPort
NULL, // userName
NULL, // password,
0, // options
VIX_INVALID_HANDLE, // propertyListHandle
vmHandle Identifies a virtual machine. Call VixVM_Open() to create a virtual
machine handle.
options Must be 0.
callbackProc A callback function that will be invoked when the power operation is
complete.
clientData A parameter that will be passed to the callbackProc function.
