PrlVmDevNet_GetNetAddresses Function

Obtains a list of IP addresses in the address/subnet_mask format which is assigned to a virtual network adapter on virtual machine startup.

Syntax

PRL_RESULT PrlVmDevNet_GetNetAddresses(
    PRL_HANDLE hVmDev, 
    PRL_HANDLE_PTR phNetAddressesList
);

File

PrlApiVm.h

Parameters

hVmDev

A handle of type PHT_VIRTUAL_DEV_NET_ADAPTER identifying the virtual network adapter.

phNetAddressesList

[out] A pointer to the PHT_STRINGS_LIST handle containing the IP addresses.

Returns

PRL_RESULT. Possible values are:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_OUT_OF_MEMORY - not enough memory to allocate strings list object.

PRL_ERR_SUCCESS - function completed successfully.

Remarks

Returns the list of pairs "IP address/Subnet mask" which will be applied to the network adapter on the guest OS side (on guest start or immediately on config commit if guest already working and Parallels tools with necessary functionality are installed). The result will be returned as list of strings (PHT_STRINGS_LIST type) of pairs "IP address/Subnet mask".