ldapssl_install_routines

Enables an existing, but new, LDAP session handle for SSL.

LDAP Version:v3
Library:*ldapssl.*
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_ssl.h>
  
  int ldapssl_install_routines (
     LDAP   *ld);

Parameters

ld

(IN) Points to the handle of the LDAP session.

Return Values

0

Success

-1

Failure

Remarks

To use this function, you must call the following LDAP function in the specified order:

  • ldapssl_client_init which initializes the SSL library

  • ldap_init which creates the session handle

  • ldapssl_install_routines which enables the session handle for SSL

Behavior is unpredictable when other LDAP functions are called between the ldap_init function and the ldapssl_install_routines function.

The preferred method is to use the ldapssl_init function.

See Also

ldapssl_client_init, ldapssl_init, ldap_init