Name

VMOpenUrlInGuest

Description

$err = VMOpenUrlInGuest($vmHandle,
                        $url,
                        $windowState,
                        $propertyListHandle);

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

Parameters

vmHandle
Identifies a virtual machine. Call VMOpen() to create a virtual machine handle.
url
The URL to be opened.
windowState
Must be 0.
propertyListHandle
Must be VIX_INVALID_HANDLE.

Return Value

$err. The error code returned by the operation.

Remarks

Side Effects

None.

Requirements

use VMWare::Vix::Simple;
use VMware::Vix::API::Constants;
since Workstation 6.0

Example


$err = VMOpenUrlInGuest($vmHandle, "http://www.vmware.com", 0,
                        VIX_INVALID_HANDLE):
die "VMOpenUrlInGuest() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;

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

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