1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55
|
.. saslman:: sasl_getcallback_t(3)
.. _sasl-reference-manpages-library-sasl_getcallback_t:
=======================================================================================
**sasl_getcallback_t** - callback function to lookup a sasl_callback_t for a connection
=======================================================================================
Synopsis
========
.. code-block:: C
#include <sasl/saslplug.h>
int sasl_getcallback_t(sasl_conn_t *conn,
unsigned long callbacknum,
int (**proc)( ),
void **pcontext);
Description
===========
.. c:function:: int sasl_getcallback_t(sasl_conn_t *conn,
unsigned long callbacknum,
int (**proc)( ),
void **pcontext);
The **sasl_getcallback_t()** function is a callback to lookup
a sasl_callback_t for a connection.
:param conn: The connection to lookup a callback for.
:param callbacknum: The number of the callback.
:param proc: Pointer to the callback function. The value of proc is
set to NULL upon failure.
:param pcontext: Pointer to the callback context. The value of pcontext
is set to NULL upon failure.
Return value
============
SASL callback functions should return SASL return codes.
See :saslman:`sasl_errors(3)` for a complete list. :c:macro:`SASL_OK` typically indicates success.
* :c:macro:`SASL_FAIL`: Unable to find a callback of the requested type.
* :c:macro:`SASL_INTERACT`: The caller must use interaction to get data.
Conforming to
=============
:rfc:`4422`
See Also
========
:saslman:`sasl(3)`, :saslman:`sasl_errors(3)`, :saslman:`sasl_callbacks(3)`
|