Netscape DIRECTORY SERVER 7.0 - PLUG-IN Manual page 380

Functions for Thread-Safe LDAP Connections
Parameters
This function takes the following parameters:
ldaphost
ldapport
secure
shared
Returns
This function returns one of the following values:
• If successful, returns a pointer to an
to subsequent calls to other LDAP API functions.
• If unsuccessful, returns
Description
This function initializes an LDAP session with another LDAP server. If you want
to connect to another LDAP server over SSL or if you want to allow multiple
threads to use the same connection, call this function instead of the
function provided with the Netscape Directory SDK.
This function allocates an
session, including the host name and port of the LDAP server, preferences for the
session (such as the maximum number of entries to return in a search), and the
error code of the last LDAP operation performed.
You can specify a list of LDAP servers that you want to attempt to connect to.
Your client will attempt to connect to the first LDAP server in the list. If the
attempt fails, your client will attempt to connect to the next LDAP server in the
list.
If you specify a non-zero value for the
the plug-in for SSL and installs the I/O routines for SSL.
380 Netscape Directory Server Plug-in Programmer's Guide • October 2004
Space-delimited list of one or more host names (or IP address in
dotted notation, such as "141.211.83.36") of the LDAP servers to
which you want to connect.
The names can be in hostname:portnumber format, in which
case, portnumber overrides the port number specified by the
ldapport argument.
Port number of the LDAP server.
Determines whether to establish the connection over SSL. Set this to
a non-zero value to establish the connection over SSL.
Determines whether the LDAP session (the LDAP structure) can be
shared by different threads. Set this to a non-zero value to allow
multiple threads to share the session.
.
NULL
structure containing information about the
LDAP
structure, which should be passed
LDAP
argument, this function initializes
secure
ldap_init()