BLE_ANCS_PerformNtfyAction
C
uint16_t BLE_ANCS_PerformNtfyAction(uint16_t connHandle, uint32_t ntfyId, BLE_ANCS_ActionId_T actId);Description
Performs an action on a specific iOS notification. This function sends a command to the iOS device to perform a specified action on a notification identified by its unique identifier (UID). The action to be performed is determined by the action ID provided.
Parameters
| Parameter | Description |
|---|---|
| [in] connHandle | The handle for the current connection with the iOS device. |
| [in] ntfyId | The 32-bit UID of the iOS notification on which to perform the action. The ntfyId can 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] actId | The action to perform on the notification. Refer to BLE_ANCS_ActionId_T for possible values. |
Return values
| Return value | Description |
|---|---|
| MBA_RES_SUCCESS | Command successfully sent to perform the action on the notification. |
| 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|No available resource to send write operation.| MBA_RES_BUSY|The GATT Client is currently busy with another operation.|