1@subheading gsasl_callback
2@anchor{gsasl_callback}
3@deftypefun {int} {gsasl_callback} (Gsasl * @var{ctx}, Gsasl_session * @var{sctx}, Gsasl_property @var{prop})
4@var{ctx}: handle received from @code{gsasl_init()} , may be NULL to derive it
5from  @code{sctx} .
6
7@var{sctx}: session handle.
8
9@var{prop}: enumerated value of Gsasl_property type.
10
11Invoke the application callback.  The  @code{prop} value indicate what the
12callback is expected to do.  For example, for
13@code{GSASL_ANONYMOUS_TOKEN} , the function is expected to invoke
14gsasl_property_set( @code{SCTX} , @code{GSASL_ANONYMOUS_TOKEN} , "token") where
15"token" is the anonymous token the application wishes the SASL
16mechanism to use.  See the manual for the meaning of all
17parameters.
18
19Note that if no callback has been set by the application, but the
20obsolete callback interface has been used, this function will
21translate the old callback interface into the new.  This interface
22should be sufficient to invoke all callbacks, both new and old.
23
24Return value: Returns whatever the application callback returns, or
25@code{GSASL_NO_CALLBACK}  if no application was known.
26
27@strong{Since:} 0.2.0
28@end deftypefun
29
30