GATTS_UpdateBondingInfo

C

uint16_t GATTS_UpdateBondingInfo(uint16_t connHandle, GATTS_BondingParams_T *p_gattsParams, uint8_t numOfCccds, GATTS_CccdList_T *p_cccdList);

Description

Notifies the local GATT Server of the bonding information for a connection.

Note

This function should be called after a connection is established, regardless of whether the connection is bonded. The GATT Server needs the bonding information to process certain requests for bonded connections. If the GATT Server is initialized with caching support (i.e., GATTS_Init with GATTS_CONFIG_CACHING_SUPPORT), this function must be invoked after the connection is established. The GATT module will then begin processing packets once the bonding information is received.

Parameters

ParameterDescription
[in] connHandleConnection handle.
[in] p_gattsParamsPointer to the GATTS bonding parameters structure (See GATTS_BondingParams_T). Set to NULL for non-bonded connections.
[in] numOfCccdsNumber of Client Characteristic Configuration Descriptors (CCCDs) for the bonded connection. Set to zero for non-bonded connections.
[in] p_cccdListPointer to the list of CCCDs for the bonded connection (See GATTS_CccdList_T). Set to NULL for non-bonded connections.

Return values

Return valueDescription
MBA_RES_SUCCESSSuccessfully notified the GATT Server of the updated parameters.
MBA_RES_INVAIID_PARAInvalid parameters; the connection handle is not valid.