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_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
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