PrlVmDevNet_SetBoundAdapterName Function

Sets the name of the network adapter to which a virtual network adapter inside a virtual machine will bind.

Syntax

PRL_RESULT PrlVmDevNet_SetBoundAdapterName(
    PRL_HANDLE hVmDev, 
    PRL_CONST_STR sNewBoundAdapterName
);

File

PrlApiVm.h

Parameters

hVmDev

A handle of type PHT_VIRTUAL_DEV_NET_ADAPTER identifying the virtual network adapter.

sNewBoundAdapterName

The name of the adapter to bind to. The adapter must exist on the host. To get the names of the available adapters from the host, use the PrlSrvCfg_GetNetAdapter function.

Returns

PRL_RESULT. Possible values:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_SUCCESS - function completed successfully.

Remarks

In a bridged networking mode, a network adapter inside a virtual machine is bound to an adapter on the host. This function allows to set the name of the adapter to bind to.