BLE_GAP_ConfigureBuildInService
C
uint16_t BLE_GAP_ConfigureBuildInService(BLE_GAP_ServiceOption_T *p_serviceOptions);Description
Configures the built-in Generic Access Service for a BLE device.
Note
This function allows customization of optional characteristics and values within the mandatory Generic Access Service. It is recommended to call this function during initialization and not when a connection is active. Once configured, the options should not be changed; if multiple configurations are required, consider the implications of service changes.
Events generated
BLE_GAP_EVT_DEVICE_NAME_CHANGED is generated when the device name characteristic is writable and is written by a remote peer.
Parameters
| Parameter | Description |
|---|---|
| [in] p_serviceOptions | Pointer to a structure defining the service options to be configured. |
Return values
| Return value | Description |
|---|---|
| MBA_RES_SUCCESS | Successfully configures the built-in Generic Access Service. |
| MBA_RES_OOM | Internal memory allocation failure occurred. |