ble_hs_stop() function

Stops the BLE host. Aborts all active GAP procedures and terminates all open connections. Connection termination is performed asynchronously, so this function's result is reported via the provided listener.

Syntax

Show:

Summary

Declaration

Definition

from ble_hs_stop.h:79

int ble_hs_stop(struct ble_hs_stop_listener *listener, ble_hs_stop_fn *fn, void *arg);

Implemented in ble_hs_stop.c:220

Arguments

Argument

Description

listener

A listener to populate. This object's initial value doesn't matter, but its lifetime must extend until the stop procedure completes.

The callback to execute when the stop procedure completes.

arg

Optional argument to pass to the callback.

Return value

0: Stop procedure successfully initiated. BLE_HS_EBUSY: Stop procedure already in progress; the provided callback gets called when the procedure completes. BLE_HS_EALREADY: Host already stopped; the provided callback does *not* get called.