CHAPTER 4 Operations on Virtual Machines
35
RC1
VixVM_CopyFileFromGuestToHost
Function Signature
VixHandle
VixVM_CopyFileFromGuestToHost(VixHandle vmHandle,
const char* guestPathName,
const char* hostPathName,
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 guest operating system to the host operating
system. The virtual machine must be running while the file is copied.
• The destination for 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.
guestPathName The path name of a file on a file system available to the guest.
hostPathName The path name of a file on a file system available to the host.
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.
