Bluetooth: Mesh: Add error code for bt_mesh_adv_terminate

Return error code to let an implementation know if the adv was actually
stopped (was scheduled) or not.

Signed-off-by: Pavel Vasilyev <pavel.vasilyev@nordicsemi.no>