www.vmware.com
22
C API Reference Guide
RC1
VixHost_Connect
Function Signature
VixHandle
VixHost_Connect(int apiVersion,
VixServiceProvider hostType,
const char *hostName,
int hostPort,
const char *userName,
const char *password,
VixHostOptions options,
VIXHandle propertyListHandle,
VIXEventProc *callbackProc,
void *clientData);
Parameters
Results
VixHandle. A job handle that describes the state of this asynchronous call.
Notes
• This function initializes the host object; you must call this before calling any
other VIX function. The host object will be used for all local VIX operations.
• This function is asynchronous. It uses a job object to report when the operaton is
complete. The function returns a handle to the job object immediately. When
apiVersion The version of the API to be supported. This is defined as
VIX_API_VERSION.
hostType The type of host being opened. Must be
VIX_SERVICEPROVIDER_VMWARE_SERVER.
hostName Name of the host to which you want to connect.
hostPort Port number on the host to which you want to connect.
userName Name of user for authentication on the host.
password Password of user for authentication on the host.
options Options for the host. See the Notes section below.
propertyListHandle Must be VIX_INVALID_HANDLE.
callbackProc A callback that will be invoked when this function completes.
clientData A parameter that will be passed to the callbackProc function.
