ldap_bind_digest_md5_start

Begins the DIGEST-MD5 SASL bind process.

LDAP Version:v2 or higher
Library:*ldapsdk.*
NDS Version:7.xx or higher
Platform:NLM, Windows (NT, 95, 98, 2000, XP, Vista 32-bit and 64-bit ), Linux (32-bit and 64-bit), Solaris, AIX, and HP-UX

Syntax

  #include <ldap.h>
  
  int ldap_bind_digest_md5_start (
     LDAP                      *ld,
     LDAP_DIGEST_MD5_CONTEXT   *digestMD5ctx
  );

Parameters

ld

(IN) the handle for the LDAP session.

digestMD5ctx

(IN) A pointer to an LDAP_DIGEST_MD5_CONTEXT variable that will be initialized with a new DIGEST-MD5 login context. This context must be used in a sebsequent call to ldap_bind_digest_md5_finish.

Return Values

0x00

LDAP_SUCCESS

Non-zero

Failure. For a complete list, see LDAP Return Codes.

Remarks

The LDAP_OPT_NETWORK_TIMEOUT option (set by calling ldap_set_option) enables you to set a timeout for the initial connection to a server. If no timeout is set, timeout depends upon the underlying socket timeout setting of the operating system.

Using the connection timeout, you can also specify multiple hosts separated by spaces in a bind call, then use a timeout to determine how long your application will wait for an initial response before attempting a connection to the next host in the list.

Passing NULL for the ld parameter of ldap_set_option sets this timeout as the default connection timeout for subsequent session handles created with ldap_init or ldapssl_init. To clear the timeout pass NULL for the invalue parameter of ldap_set_option.

A connection timeout will cause an LDAP_SERVER_DOWN error (81) "Can't contact LDAP server".

See Also

ldap_get_digest_md5_realms, ldap_bind_digest_md5_finish