netstatus_get_interface

Get the details of a specified network interface.

Synopsis:

#include <bps/netstatus.h>

BPS_API int netstatus_get_interface_details(const char *interface,
                                            netstatus_interface_details_t **details)

Since:

BlackBerry 10.0.0

Arguments:

interface: the interface to get the details of. Should be one of the interfaces received from netstatus_get_interfaces(), or netstatus_info_get_default_interface(). If NULL, reports the details of the default interface, if there is one.

details: This will be populated with the network interface details. The caller must call netstatus_free_interface_details() when done with this structure.

Library:

libbps (For the qcc command, use the -l bps option to link against this library)

Description:

The netstatus_get_interface_details() function gets the details of the specified network interface.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.