sasl_getrealm_t(10 July 2001)       sasl_getrealm_t(10 July 2001)



NAME
       sasl_getrealm_t - Realm Acquisition Callback


SYNOPSIS
       #include 


       int sasl_getrealm_t(void *context, int id,
                       const char **availrealms,
                           const char **result)


DESCRIPTION
       sasl_getrealm_t  is used when there is an interaction with
       SASL_CB_GETREALM as the type.

       If a mechanism would use this callback, but it is not pre-
       sent,   then  the  first  realm  listed  is  automatically
       selected.  (Note that a  mechanism  may  still  force  the
       existence  of  a  getrealm callback by SASL_CB_GETREALM to
       its required_prompts list).

       context context from the callback record

       id callback ID (SASL_CB_GETREALM)

       availrealms A string list of the available  realms.   NULL
       terminated, may be empty.

       result The chosen realm. (a NUL terminated string)


RETURN VALUE
       SASL  callback  functions should return SASL return codes.
       See sasl.h for a complete list. SASL_OK indicates success.


SEE ALSO
       sasl(3), sasl_callbacks(3)



SASL man pages                 SASL sasl_getrealm_t(10 July 2001)