nabto_device_listener_connection_event()

DESCRIPTION

Start listening for next connection event.

Future status:

  • NABTO_DEVICE_EC_OK if event new event is set
  • NABTO_DEVICE_EC_OPERATION_IN_PROGRESS if listener already have a future
  • NABTO_DEVICE_EC_OUT_OF_MEMORY if future or and underlying structure could not be allocated
  • NABTO_DEVICE_EC_ABORTED if underlying service stopped (eg. if device closed)
  • NABTO_DEVICE_EC_STOPPED if the listener was stopped

DECLARATION

NABTO_DEVICE_DECL_PREFIX void NABTO_DEVICE_API
nabto_device_listener_connection_event(NabtoDeviceListener* listener,
                                       NabtoDeviceFuture* future,
                                       NabtoDeviceConnectionRef* ref,
                                       NabtoDeviceConnectionEvent* event)

PARAMETERS

listener:
[in] Listener to get connection events from
future:
[in] Future which resolves when event is ready or on errors.
ref:
[out] Where to put the connection reference when the future resolves.
event:
[out] Where to put the connection event when the future resolves.