CHAPTER 4 Operations on Virtual Machines
51
RC1
VixVM_InstallTools
Function Signature
VixHandle
VixVM_InstallTools(VixHandle vmHandle,
int options,
char *commandLineArgs,
VixEventProc *callbackProc,
void *clientData);
Parameters
Results
Results
VixHandle — A job handle that describes the state of this asynchronous operation.
Notes
• Installs VMware Tools on the guest operating system. If VMware Tools is already
installed, this function upgrades VMware Tools to the version that matches the
Vix library.
• The virtual machine must be powered on 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
vmHandle Identifies a virtual machine. Call VixVM_Open() to create a virtual
machine handle.
options Must be 0.
commandLineArgs Must be NULL.
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.
