This function was removed in version 1.11.

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

This function is deprecated and may be removed from future versions of the VIX API.
This function opens the URL in the guest operating system.
You must call VixVM_LoginInGuest() with VIX_LOGIN_IN_GUEST_REQUIRE_INTERACTIVE_ENVIRONMENT in the options, and enable autologin on the guest operating system, before calling this function.

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...
}