ldapOpen(3ibx) — Subroutines
NAME
ldapOpen − Initializes an LDAP handle, and, if successful, establishes a network connection to an LDAP-compliant server.
SYNOPSIS
| #include <libldap.h> | ||
| int ldapOpen( | LDAP_t ∗ldap_handle, | |
| unsigned int transport, | ||
| char ∗server_name, | ||
| char ∗endpoint ); |
OUTPUT PARAMETER
ldap_handleThe address of an LDAP handle.
INPUT PARAMETERS
transportOne of the following constants, which indicates the network transport to use for client/server communications:
| LDAP_DECNET | A DECnet network. | |
| LDAP_TCPIP | A TCP/IP network. |
server_nameThe address of a character string that specifies the name of the machine running the server.
end_pointThe address of a character string that contains the name of the network endpoint for the process that runs the server. The default endpoint names for the InfoBroker server are as follows:
| LDAP_DECNET_SERVER | Endpoint name for DECnet, | |
| whose value is "LDAP_SERVER". | ||
| LDAP_TCPIP_SERVER | Endpoint for TCP/IP, whose | |
| value translates to the port | ||
| number "389". |
DESCRIPTION
If a call to ldapOpen fails, call ldapDelete to free the ldap_handle. After you initialize the LDAP handle with a call to ldapOpen, call the ldapBind function to bind the client and server.
RETURNS
One of the LDAP standard return values: LDAP_message.
RELATED INFORMATION
Functions: ldapDelete(3).