1.2.2.3.1.1.4.4 BLE_ANCS_GetAppAttr
C
uint16_t BLE_ANCS_GetAppAttr(uint16_t connHandle, uint8_t *p_appId, BLE_ANCS_AppAttrsMask_T bitmask);Description
This API triggers ANCS client role (Notification Consumer) to retrieve a specific app attributes installed on the iOS device (Notification Provider).
Parameters
| Parameter | Description |
|---|---|
| [in] connHandle | The connection handle. |
| [in] p_appId | Pointer to App Identifier(string with NULL-terminated) would like to get. App Identifier could be retrieved when receiving BLE_ANCS_EVT_NTFY_ATTR_IND event. |
| [in] bitmask | Bitmask value of App Attribute . Set true to enable retrieving, otherwise set to false. See BLE_ANCS_AppAttrsMask_T. |
Return values
| Return value | Description |
|---|---|
| MBA_RES_SUCCESS | Successfully issue a Get App 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. |