BLE_ANCS_GetNtfyAttr
C
uint16_t BLE_ANCS_GetNtfyAttr(uint16_t connHandle, uint32_t ntfyId, BLE_ANCS_NtfyAttrsMask_T bitmask);Description
Requests attributes for a specific iOS notification. This function triggers the ANCS client role to retrieve notification attributes from an iOS device.
Parameters
| Parameter | Description |
|---|---|
| [in] connHandle | The connection handle associated with the iOS device. |
| [in] ntfyId | The unique identifier for the iOS notification. 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 | A bitmask specifying which notification attributes to retrieve. Refer to BLE_ANCS_NtfyAttrsMask_T for possible values. |
Return values
| Return value | Description |
|---|---|
| MBA_RES_SUCCESS | Get notification attributes was issued successfully. |
| MBA_RES_FAIL | The operation is not permitted. |
| MBA_RES_OOM | Internal memory allocation failure. |
| MBA_RES_INVALID_PARA | Invalid parameters were provided. Possible reasons include: |
- Invalid connection handle.
- Invalid write parameters. See GATTC_WriteParams_T for valid values.| MBA_RES_NO_RESOURCE|Insufficient resources to perform the operation.| MBA_RES_BUSY|The GATT Client is currently busy with another operation.|