sd_ble_gap_device_name_set()

uint32_t sd_ble_gap_device_name_set	(	ble_gap_conn_sec_mode_t const *	p_write_perm,
		uint8_t const *	p_dev_name,
		uint16_t	len )

#include <ble_gap.h>

Set GAP device name.

Note

If the device name is located in application flash memory (see ble_gap_cfg_device_name_t), it cannot be changed. Then NRF_ERROR_FORBIDDEN will be returned.

Parameters

[in]	p_write_perm	Write permissions for the Device Name characteristic, see ble_gap_conn_sec_mode_t.
[in]	p_dev_name	Pointer to a UTF-8 encoded, non NULL-terminated string.
[in]	len	Length of the UTF-8, non NULL-terminated string pointed to by p_dev_name in octets (must be smaller or equal than BLE_GAP_DEVNAME_MAX_LEN).

Return values

NRF_SUCCESS	GAP device name and permissions set successfully.
NRF_ERROR_INVALID_ADDR	Invalid pointer supplied.
NRF_ERROR_INVALID_PARAM	Invalid parameter(s) supplied.
NRF_ERROR_DATA_SIZE	Invalid data size(s) supplied.
NRF_ERROR_FORBIDDEN	Device name is not writable.