PrlVirtNet_GetBoundAdapterInfo Function

Obtains physical adapter info which bound to the virtual network object.

Syntax

PRL_RESULT PrlVirtNet_GetBoundAdapterInfo(
    PRL_HANDLE hVirtNet, 
    PRL_HANDLE hSrvConfig, 
    PRL_HANDLE_PTR phNetAdapter
);

hVirtNet

A handle of type PHT_VIRTUAL_NETWORK identifying the virtual network.

hSrvConfig

A handle of type PHT_SERVER_CONFIG which provides host hardware information.

phNetAdapter

[out] A pointer to a variable that receives the new handle of PHT_HW_NET_ADAPTER object.

PRL_RESULT . Possible values:

PRL_ERR_INVALID_ARG - invalid handle of virtual network object or invalid handle of host hardware info or null pointer was passed.

PRL_ERR_NETWORK_ADAPTER_NOT_FOUND - correspond network adapter is absent at provided host

PRL_ERR_OUT_OF_MEMORY - not enough memory to create the object of network adapter.

PRL_ERR_SUCCESS - function completed successfully.

This method provided for convenience in order do not create own algorithm of bound to the virtual network physical adapter information.