PrlVmDevNet_GetBoundAdapterIndex Function

Returns the index of the adapter to which the specified virtual adapter is bound.

Syntax

PRL_RESULT PrlVmDevNet_GetBoundAdapterIndex(
    PRL_HANDLE hVmDev, 
    PRL_INT32_PTR pnIndex
);

File

PrlApiVm.h

Parameters

hVmDev

A handle of type PHT_VIRTUAL_DEV_NET_ADAPTER identifying the virtual network adapter.

pnIndex

[out] A pointer to a variable that receives the index. A returned value of -1 (negative one) indicates that the virtual network adapter is bound to the default adapter on the host.

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 retrieve the index of the adapter from the host.