.TH SXMSG_RETURN 3 "20 July 2015" "SNTLLv2" "SNTL Library Manual"
.SH NAME
sxmsg_return \- Return a message with error and close dialog.
.br
sxmsg_return_pp \- Return a message with error and close dialog in postponed message send mode.
.SH SYNOPSIS
.B #include <sntl/sntllv2.h>
.br
.sp
int sxmsg_return(sxmsg_t *msg, int opcode);

int sxmsg_return_pp(sxmsg_t *msg, int opcode);

.br
.sp
.SH DESCRIPTION
.B sxmsg_return
Will return a message with error code
.B opcode
 pointed by
.B msg. 
This message will be sent within context of the calling thread.
.br
.B sxmsg_reply_pp
Will do exactly the same, but message sending will be postponed and sent by one of the thread serving the underlying connection link.
.br
.SH RETURN VALUE
Functions may fail with the following errors:
.br
.B SNE_SUCCESS
will returns if message was processed and dialog is closed.
.br
.B SNE_FAILED
pointed data is invalid.
.br
.B SNE_ENOMEM
not available memory for operation.
.br
.B SNE_BADPROTO
bad protocol.
.br
.B SNE_NOSUCHCHAN
Pointed channel doesn't exists
.br
.B SNE_ETIMEDOUT
Other side timedout with replying to your message.
.br
.B SNE_LINKBROKEN
Connection link is broken during a message send.
.br
.SH BUGS
Not known yet.
.SH EXAMPLE
None.
.SH APPLICATION USAGE
None.
.SH RATIONALE
None.
.SH SEE_ALSO
.BI sxchannel_open(3)
,
.BI sxchannel_close(3)
,
.BI sxmsg_reply(3)
,
.BI sxmsg_rreply(3)
,
.BI sxmsg_return(3)
,
.BI sxmsg_send(3)
.SH COPYRIGHT
This is a proprietary software. See COPYING for further details.
.br
(c) Askele Group 2013-2015 <http://askele.com>
.SH AUTHOR
Alexander Vdolainen (vdo@askele.com)