opensolaris man page for sasl_getcallback_t

sasl_getcallback_t(3SASL)		      Simple Authentication Security Layer Library Functions			 sasl_getcallback_t(3SASL)

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 com-
       plete 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(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWlibsasl		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       sasl_errors(3SASL), attributes(5)

SunOS 5.11							    27 Oct 2003 					 sasl_getcallback_t(3SASL)