Name

Description

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

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

This function opens the URL in the guest operating system.
You must call VM::LoginInGuest() with

VixCOM.Constants.VIX_CONSOLE_USER_NAME as the userName and NULL (C++), null (C#), or Nothing (VB). as the password before calling this function.

Side Effects

None.

Requirements

VixCOM.h, since VMware Workstation 6.0

Example

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