NAME

sasl_getcallback_t - callback function to lookup a sasl_callback_t for a connection

SYNOPSIS

cc [ flag ... ] file ... -lsasl   [ library ... ]
#include <sasl/saslplug.h>
int sasl_getcallback_t(sasl_conn_t *conn, unsigned long callbacknum,


     int (**proc)( ), void **pcontext);

DESCRIPTION

The sasl_getcallback_t() function is a callback to lookup a sasl_callback_t for a connection.

PARAMETERS

conn

The connection to lookup a callback for.

callbacknum

The number of the callback.

proc

Pointer to the callback function. The value of proc is set to NULL upon failure.

pcontext

Pointer to the callback context. The value of pcontext is set to NULL upon failure.

RETURN VALUES

Like other SASL callback functions, sasl_getcallback_t() returns an integer that corresponds to a SASL error code. See <sasl.h> for a complete list of SASL error codes.

ERRORS

SASL_OK

The call to sasl_getcallback_t() was successful.

SASL_FAIL

Unable to find a callback of the requested type.

SASL_INTERACT

The caller must use interaction to get data.

See sasl_errors(3SASL) for information on SASL error codes.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving
MT-Level	MT-Safe