PrlVmDevNet_SetConfigureWithDhcp Function

Allows to specify whether a network adapter in a virtual machine should be configured through DHCP or manually.

Syntax

PRL_RESULT PrlVmDevNet_SetConfigureWithDhcp(
    PRL_HANDLE hVmDev, 
    PRL_BOOL bConfigureWithDhcp
);

File

PrlApi.h

Parameters

hVmDev

A handle of type PHT_VIRTUAL_DEV_NET_ADAPTER identifying the virtual network adapter.

bConfigureWithDhcp

Specify PRL_TRUE to configure the adapter through DHCP. Specified PRL_FALSE to configure the network settings manually.

Returns

PRL_RESULT . Possible values:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_SUCCESS - function completed successfully.

Remarks

Note: For these changes to take effect, Parallels Tools must be installed in the target virtual machine, and its network adapter settings should be configured to change automatically.

If the changes are applied to a stopped virtual machine, they will take effect the next time the machine is started. If the changes are applied to a running virtual machine, they will take effect on configuration changes commit.