1.1.2.1.1.4.67 BLE_GAP_SetScanRspData
C
uint16_t BLE_GAP_SetScanRspData(BLE_GAP_AdvDataParams_T *p_scanData);Description
Set scan response data.
Note
If advertising is currently enabled, the new data shall be used in subsequent advertising events. If an advertising event is in progress when this command is issued, the new data may not be used for that event.
This API belongs to legacy advertising feature. It will be disallowed if any one API belongs extended advertising feature is issued before. Categories of advertising APIs and events for details of advertising APIs.
BLE_GAP_AdvInit is required for this API.
Parameters
| Parameter | Description |
|---|---|
| [in] p_scanData | Pointer to the structure containing scan response data to be set. See BLE_GAP_AdvDataParams_T. |
Return values
| Return value | Description |
|---|---|
| MBA_RES_SUCCESS | Successfully set scan response data. |
| MBA_RES_OOM | Internal memory allocation failure. |
| MBA_RES_INVALID_PARA | Invalid parameters, scan response data length is more than BLE_GAP_ADV_MAX_LENGTH. |
| MBA_RES_COMMAND_DISALLOWED | Command disallowed when extended Adv. feature is in-use. |