This function was removed in version 1.11.

Name

VMOpenUrlInGuest

Description

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

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 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. For returned values, see Topics > Error Codes.

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 VMLoginInGuest() 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

use VMware::Vix::Simple;
use VMware::Vix::API::Constants;

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

Example


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