1.2.2.3.1.1.4.5 BLE_ANCS_GetNtfyAttr
C
uint16_t BLE_ANCS_GetNtfyAttr(uint16_t connHandle, uint32_t ntfyId, BLE_ANCS_NtfyAttrsMask_T bitmask);Description
This API triggers ANCS client role (Notification Consumer) to retrieve a specific iOS notification attributes from iOS device (Notification Provider).
Parameters
| Parameter | Description |
|---|---|
| [in] connHandle | The connection handle. |
| [in] ntfyId | Notification UID. The ntfyId could be retrieved when receiving BLE_ANCS_EVT_NTFY_ADDED_IND or BLE_ANCS_EVT_NTFY_MODIFIED_IND or BLE_ANCS_EVT_NTFY_REMOVED_IND. events. |
| [in] bitmask | Bitmask value of Notification Attribute. Set true to enable retrieving, otherwise set to false. See BLE_ANCS_NtfyAttrsMask_T. |
Return values
| Return value | Description |
|---|---|
| MBA_RES_SUCCESS | Successfully issue a Get Notification Attributes command. |
| MBA_RES_FAIL | Operation is not permitted. |
| MBA_RES_OOM | Internal memory allocation failure. |
| MBA_RES_INVALID_PARA | Invalid parameters. One of the following reasons: - Connection handle is not valid - Invalid write parameters. See GATTC_WriteParams_T for valid values. |
| MBA_RES_NO_RESOURCE | No available resource to send write operation. |
| MBA_RES_BUSY | GATT Client is busy. Another request is ongoing. |