Functions
[Database Discovery]

Function for closing the DB Discovery module.

This function will clear up any internal variables and states maintained by the module. To re-use the module after calling this function, the function ble_db_discovery_init must be called again.

Return values:

NRF_SUCCESS

Operation success.

Function for registering with the DB Discovery module.

The application can use this function to inform which service it is interested in discovering at the server.

Parameters:

[in]	p_uuid	Pointer to the UUID of the service to be discovered at the server.
[in]	evt_handler	Event handler to be called by the DB discovery module when any event related to discovery of the registered service occurs.

Note:

The total number of services that can be discovered by this module is BLE_DB_DISCOVERY_MAX_SRV. This effectively means that the maximum number of registrations possible is equal to the BLE_DB_DISCOVERY_MAX_SRV.

Return values:

NRF_SUCCESS	Operation success.
NRF_ERROR_NULL	When a NULL pointer is passed as input.
NRF_ERROR_INVALID_STATE	If this function is called without calling the ble_db_discovery_init.
NRF_ERROR_NOT_SUPPORTED	The maximum number of registrations allowed by this module has been reached.

Function for initializing the DB Discovery module.

Return values:

NRF_SUCCESS

on successful initialization.

Function for handling the Application's BLE Stack events.

Parameters:

[in,out]	p_db_discovery	Pointer to the DB Discovery structure.
[in]	p_ble_evt	Pointer to the BLE event received.

Function for starting the discovery of the GATT database at the server.

Warning:

p_db_discovery structure must be zero-initialized.

Parameters:

[out]	p_db_discovery	Pointer to the DB Discovery structure.
[in]	conn_handle	The handle of the connection for which the discovery should be started.

Return values:

NRF_SUCCESS	Operation success.
NRF_ERROR_NULL	When a NULL pointer is passed as input.
NRF_ERROR_INVALID_STATE	If this function is called without calling the ble_db_discovery_init, or without calling ble_db_discovery_evt_register.
NRF_ERROR_BUSY	If a discovery is already in progress for the current connection.

Returns:

This API propagates the error code returned by the SoftDevice API sd_ble_gattc_primary_services_discover.