Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlVmCfg_SetDnsServers Function
PHT_VM_CONFIGURATION

Allows to manually assign DNS servers a virtual machine.

Syntax
PRL_RESULT PrlVmCfg_SetDnsServers(
    PRL_HANDLE hVmCfg, 
    PRL_HANDLE hDnsServersList
);
File

PrlApiVm.h

Parameters

hVmCfg
A handle of type PHT_VM_CONFIGURATION identifying the virtual machine configuration.
hDnsServersList
A handle of type PHT_STRINGS_LIST containing the list of DNS servers to be assigned to the network adapter. Can be PRL_INVALID_HANDLE if it's necessary to specify an empty list.

Returns

PRL_RESULT. Possible values: 

PRL_ERR_INVALID_ARG - invalid handle of virtual network adapter specified. 

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.

Links
© 2021 Parallels International GmbH. All rights reserved.