CHAPTER 4 Operations on Virtual Machines
39
RC1
VixVM_CopyFileFromHostToGuest
Function Signature
VixHandle
VixVM_CopyFileFromHostToGuest(VixHandle vmHandle,
const char* hostPathName,
const char* guestPathName,
int options,
VixHandle propertyList,
VixEventProc *callbackProc,
void *clientData);
Parameters
Results
VixHandle — A job handle that describes the state of this asynchronous operation.
Notes
• This function copies a file from the host operating system to the guest operating
system. The virtual machine must be running while the file is copied.
• The file must be on the same host that is running the virtual machine.
• The format of the file name depends on the guest or host operating system. For
example, a path name for a Windows guest or host requires backslash as a
directory separator, whereas a Linux guest or host requires a forward slash. If the
path name includes backslash characters, you need to precede each one with an
escape character.
• You must call VixVM_LoginInGuest() before calling this procedure.
vmHandle Identifies a virtual machine. Call VixVM_Open() to create a virtual
machine handle.
hostPathName The path name of a file on a file system available to the host.
guestPathName The path name of a file on a file system available to the guest.
options Must be 0.
propertyList Must be VIX_INVALID_HANDLE.
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.
