Name

VixVM_OpenUrlInGuest

Description

VixHandle
VixVM_OpenUrlInGuest(VixHandle vmHandle,
                     const char *url,
                     int windowState,
                     VixHandle propertyListHandle,
                     VixEventProc *callbackProc,
                     void *clientData);

This function is deprecated. This function opens a browser window on the specified URL in the guest operating system.

Parameters

vmHandle
Identifies a virtual machine. Call VixVM_Open() to create a virtual machine handle.
url
The URL to be opened.
windowState
Must be 0.
propertyListHandle
Must be VIX_INVALID_HANDLE.
callbackProc
A callback function that will be invoked when the operation is complete.
clientData
A parameter that will be passed to the callbackProc function.

Return Value

VixHandle. A job handle that describes the state of this asynchronous operation.

Remarks

Side Effects

None.

Requirements

vix.h, since VMware Workstation 6.0
Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

Example


jobHandle = VixVM_OpenUrlInGuest(vmHandle,
                                 "http://www.vmware.com",
                                 0,
                                 VIX_INVALID_HANDLE, // propertyListHandle,
                                 NULL, // callbackProc,
                                 NULL); // clientData
err = VixJob_Wait(jobHandle, VIX_PROPERTY_NONE);

if (VIX_OK != err) {
   // Handle the error...
}

Copyright (C) 2007-2010 VMware, Inc. All rights reserved.