1.2.2.1.1.4.47 BLE_GAP_SetExtAdvData
C
uint16_t BLE_GAP_SetExtAdvData(BLE_GAP_ExtAdvDataParams_T *p_advDataParam);
Description
Configure extended advertising data.
Note
This API may be issued at any time after an advertising set identified by the advHandle parameter has been created using the BLE_GAP_SetExtAdvParams API. No matter advertising in that set is enabled or disabled.
This API belongs to extended advertising feature. It will be disallowed if any one API that belongs to legacy advertising feature is issued before. Categories of advertising APIs and events for details of advertising APIs.
BLE_GAP_AdvInit and BLE_GAP_ExtAdvInit are required for this API.
Parameters
Parameter | Description |
---|---|
[in] p_advDataParam | Pointer to BLE_GAP_ExtAdvDataParams_T structure buffer. |
Return values
Return value | Description |
---|---|
MBA_RES_SUCCESS | Successfully configure extended advertising data. |
MBA_RES_OOM | Internal memory allocation failure. |
MBA_RES_INVALID_PARA | Invalid parameters. |
MBA_RES_COMMAND_DISALLOWED | Command disallowed. |
MBA_RES_UNKNOWN_ADV_ID | Unknown advertising identifier. |