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
Parameter | Description |
---|---|
[in] connHandle | Connection handle. |
[in] p_gattsParams | Pointer to the GATTS bonding parameters structure (See GATTS_BondingParams_T). Set to NULL for non-bonded connections. |
[in] numOfCccds | Number of Client Characteristic Configuration Descriptors (CCCDs) for the bonded connection. Set to zero for non-bonded connections. |
[in] p_cccdList | Pointer to the list of CCCDs for the bonded connection (See GATTS_CccdList_T). Set to NULL for non-bonded connections. |
Return values
Return value | Description |
---|---|
MBA_RES_SUCCESS | Successfully notified the GATT Server of the updated parameters. |
MBA_RES_INVAIID_PARA | Invalid parameters; the connection handle is not valid. |