Ldap parse sasl bind result

Function : LDAP

ldap_parse_sasl_bind_result - Extract information from LDAP results.

#include <ldap.h>
int LNPUBLIC ldap_parse_sasl_bind_result(

    LDAP *ld,
    LDAPMessage *res,
    struct berval **servercredp,
    int  freeit);

Description :

This function will extract information from results and handle errors returned by other LDAP API routines.

Note that ldap_parse_sasl_bind_result() and ldap_parse_extended_result must typically be used in addition to ldap_parse_result to retrieve all the result information from SASL Bind and Extended Operations respectively. The ldap_parse_result, ldap_parse_sasl_bind_result, and ldap_parse_extended_result functions all skip over messages of type LDAP_RES_SEARCH_ENTRY and LDAP_RES_SEARCH_REFERENCE when looking for a result message to parse. See LDAP_RES_xxx. If a chain of messages that contains more than one result message is passed to these routines they always operate on the first result in the chain.

Implemented as a macro:

#define ldap_parse_sasl_bind_result(ld, res, servercredp, freeit) \ ND_ldap_parse_sasl_bind_result((ld), (res), (servercredp), (freeit))

Parameters : Input : ld - The LDAP session handle.

res - The result of an LDAP operation as returned by ldap_result or one of the synchronous API operation calls.

servercredp - NULL, to ignore this field.

freeit - A boolean that determines whether the result parameter is disposed of or not. If freeit is non-zero, the entire chain of messages represented by result is disposed of after extracting the requested information. This is provided as a convenience; zero can also be passed, to not free the messages, and ldap_msgfree can be used to free the result later.

Output : (routine) - LDAP_SUCCESS - If the request was successfully sent, or another LDAP result code if not.

servercredp - The credentials passed back by the server for mutual authentication, if given. An allocated berval structure is returned that SHOULD be disposed of by calling ber_bvfree.