netstatus_get

Retrieve the current network status information.

Synopsis:

#include <bps/netstatus.h>

BPS_API int netstatus_get_info(netstatus_info_t **info)

Since:

BlackBerry 10.2.0

Arguments:

info: If this function successfully completes, this pointer is populated with the network status information. The caller must call the netstatus_free_info() function when finished with using the info value. If the function does not complete successfully, the pointer is set to NULL.

Library:

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

Description:

The netstatus_get_info() function gets the current network status information. Details about the network status can be extracted using the netstatus_info_get_*() functions. netstatus_free_info() must be used on the network status information structure when your application is finished using it.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.