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

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