BLE_ANCS_GetAppAttr
C
uint16_t BLE_ANCS_GetAppAttr(uint16_t connHandle, uint8_t *p_appId, BLE_ANCS_AppAttrsMask_T bitmask);Description
Retrieves attributes for a specific app on an iOS device.
Parameters
| Parameter | Description |
|---|---|
| [in] connHandle | The handle for the current connection with the iOS device. |
| [in] p_appId | Pointer to a null-terminated string representing the app's identifier. App Identifier can be retrieved when receiving BLE_ANCS_EVT_NTFY_ATTR_IND event. |
| [in] bitmask | Bitmask specifying which app attributes to retrieve. Refer to BLE_ANCS_AppAttrsMask_T for possible values. |
Return values
| Return value | Description |
|---|---|
| MBA_RES_SUCCESS | Command successfully sent to retrieve app attributes. |
| 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.|