Function bt_id_delete

Source
pub unsafe extern "C" fn bt_id_delete(id: u8) -> c_int
Expand description

@brief Delete an identity address.

When given a valid identity handle this function will disconnect any connections (to the corresponding identity address) created using it, remove any pairing keys or other data associated with it, and then flag is as deleted, so that it can not be used for any operations. To take back into use the slot the identity address was occupying, the bt_id_reset() API needs to be used.

@note The default identity address (corresponding to BT_ID_DEFAULT) cannot be deleted, and this API will return an error if asked to do that.

@param id Existing identity handle.

@return 0 in case of success, or a negative error code on failure.