1. Manuals
  2. Tumbleweed
  3. wslay-devel
  4. wslay_event_queue_close(3)

Scroll to navigation

WSLAY_EVENT_QUEUE_CLOSE(3) wslay WSLAY_EVENT_QUEUE_CLOSE(3)

NAME

wslay_event_queue_close - Queue a close control frame

SYNOPSIS

#include <wslay/wslay.h>


DESCRIPTION

wslay_event_queue_close() queues close control frame. This function is provided just for convenience. wslay_event_queue_msg() can queue a close control frame as well. status_code is the status code of close control frame. reason is the close reason encoded in UTF-8. reason_length is the length of reason in bytes. reason_length must be less than 123 bytes.

If status_code is 0, reason and reason_length is not used and close control frame with zero-length payload will be queued.

This function just queues a message and does not send it. wslay_event_send() function call sends these queued messages.

RETURN VALUE

wslay_event_queue_close() returns 0 if it succeeds, or returns the following negative error codes:

Could not queue given message. The one of possible reason is that close control frame has been queued/sent and no further queueing message is not allowed.
The given message is invalid.
Out of memory.

SEE ALSO

wslay_event_queue_msg(), wslay_event_queue_fragmented_msg()

AUTHOR

Tatsuhiro Tsujikawa

COPYRIGHT

2021, 2015, Tatsuhiro Tsujikawa

July 9, 2021 1.1.1