Name

OpenUrlInGuest

Description

HRESULT
OpenUrlInGuest([in] BSTR url,
               [in] LONG windowState,
               [in] IVixHandle* propertyList,
               [in] ICallback* jobDoneCallback,
               [out,retval] IJob** openJob);

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

Parameters

url
The URL to be opened.
windowState
Must be 0.
propertyListHandle
Must be NULL (C++), null (C#), or Nothing (VB).
jobDoneCallback
An ICallback instance that will be called when the operation is complete.
openJob
Returns an IJob object that describes the state of this asynchronous operation.

Return Value

HRESULT

Remarks

VixCOM.Constants.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

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

Example


VBScript:
Dim err
Dim job

Set job = vm.OpenUrlInGuest("http://www.vmware.com", 0, Nothing, Nothing)
err = job.WaitWithoutResults()
If lib.ErrorIndicatesFailure(err) Then
   ' Handle the error...
End If

Set job = Nothing

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