CHAPTER 3 Operations on Host Machines
31
RC1
VixHost_UnregisterVM
Function Signature
VixHandle
VixHost_UnregisterVM(VixHandle hostHandle,
const char *vmxFilePath,
VixEventProc *callbackProc,
void *clientData);
Parameters
Results
VixHandle. A job handle that describes the state of this asynchronous call.
Notes
• This function removes a virtual machine from the local host’s inventory. The
virtual machine is identified by the vmxFilePathName, which is a path name
to the configuration file (.VMX file) for that virtual machine.
• The format of the path name depends on the host operating system. If the path
name includes backslash characters, you need to precede each one with an
escape character.
• This function is asynchronous. Completion is reported by a job handle.
hostHandle The host handle returned by VixHost_Connect().
vmxFilePath The path name of the .vmx file on the local host.
callbackProc A function to be invoked when VixHost_UnregisterVM() completes.
clientData A user-supplied parameter to be passed to the callback function.
