www.vmware.com
54
C API Reference Guide
RC1
VixVM_LoginInGuest
Function Signature
VixHandle
VixVM_LoginInGuest(VixHandle vmHandle,
char *userName,
char *password,
int options,
VixEventProc *callbackProc,
void *clientData);
Parameters
Results
Results
VixHandle — A job handle that describes the state of this asynchronous operation.
Notes
• This function validates that the account name and password are valid. You must
call this function before calling functions to perform operations on the guest
operating system, such as VixVM_RunProgramInGuest(). If you do not
call any guest functions, you do not need to call
VixVM_LoginInGuest().
• The virtual machine must be powered on before calling this function.
• VMware Tools must be installed and running on the guest operating system
before calling this function.
vmHandle Identifies a virtual machine. Call VixVM_Open() to create a virtual
machine handle.
userName The name of a user account on the guest operating system.
password The password of the account identified by userName.
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.
