Netscape DIRECTORY SERVER 6.1 - PLUG-IN Manual page 107

• is a pointer to an array of
serverctrls
the LDAP v3 server controls that you want passed to the server for the bind
operation.
is a pointer to an array of
•
clientctrls
the LDAP v3 client controls applicable to the bind operation.
• is a pointer to the message ID for this bind operation. To check the
msgidp
result of this operation, call the
ldap_parse_sasl_bind_result()
• is a pointer to a pointer to the
servercredp
credentials returned by the server. These are the credentials that you set as the
value of the
SLAPI_BIND_RET_SASLCREDS
plug-in function.
If you are call the
ldap_sasl_bind()
function to get the result of the authentication attempt:
ldap_result()
LDAP_API(int) LDAP_CALL ldap_result( LDAP *ld, int msgid, \
int all, struct timeval *timeout, LDAPMessage **result );
The parameters are described below:
• is the connection handle, which is a pointer to the LDAP structure
ld
containing information about the connection to the LDAP server.
• is the message ID returned as the last argument of the
msgid
ldap_sasl_bind()
• applies to LDAP search operations. Since this is not an LDAP search
all
operation, you can pass NULL for this argument.
• is
the maximum interval to wait for the selection to complete. If timeout is
timeout
a NULL pointer, the select blocks indefinitely. To effect a poll, the timeout parameter
should be a non-NULL pointer, pointing to a zero-valued timeval structure.
• is a pointer to an
result
bind operation. You need to pass this to the
ldap_parse_sasl_bind_result()
After calling
ldap_result()
ldap_parse_sasl_bind_result()
LDAP result code and any credentials returned by the server:
LDAP_API(int) LDAP_CALL ldap_parse_sasl_bind_result( LDAP *ld, \
LDAPMessage *res, struct berval **servercredp, int freeit);
The parameters are described below:
LDAPControl
LDAPControl
ldap_result()
function.
parameter in your pre-operation bind
function, you need to call the
function.
structure containing the results of the
LDAPMessage
function.
, you need to call the
function to parse the results and retrieve the
Chapter 8
Using SASL with an LDAP Client
structures representing
structures representing
function and the
structure containing any
berval
Defining Functions for Authentication 107