Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlVmDevNet_SetDefaultGateway Function
PHT_VIRTUAL_DEV_NET_ADAPTER  See Also

Allows to manually set the default gateway address for a network adapter in a virtual machine.

Syntax
PRL_RESULT PrlVmDevNet_SetDefaultGateway(
    PRL_HANDLE hVmDev, 
    PRL_CONST_STR sNewDefaultGateway
);
File

PrlApiVm.h

Parameters

hVmDev
A handle of type PHT_VIRTUAL_DEV_NET_ADAPTER identifying the virtual network adapter.
sNewDefaultGateway
The new default gateway address. The specified string must be encoded using UTF-8 and must be terminated with the binary zero character.

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.

See Also
Links
© 2021 Parallels International GmbH. All rights reserved.