ldap_simple_bind_s()--Perform a Simple LDAP Bind Request (Synchronous)

Syntax #include <ldap.h> int ldap_simple_bind_s( LDAP *ld, char *dn, char *passwd) Threadsafe: Yes

The ldap_simple_bind_s() function is used to authenticate a distinguished name (DN) to a directory server.

After a connection is made to an LDAP server by using the ldap_open() API, an LDAP bind API must be called before any other LDAP APIs can be called for that connection.

ldap_simple_bind_s() is a synchronous request.

Authorities and Locks

No OS/400 authority is required. All authority checking is done by the LDAP server.

Parameters

ld

(Input) Specifies the LDAP pointer returned by a previous call to ldap_init(),ldap_ssl_init(), or ldap_open().

dn

(Input) Specifies the Distinguished Name of the entry to bind as.

passwd

(Input) Specifies the password used in association with DN of the entry in which to bind.

Return Value

LDAP_SUCCESS

if the request was successful.

another LDAP error

if the request was not successful.

Error Conditions

If ldap_simple_bind() is not successful, it returns another LDAP error code. See LDAP Client API Error Conditions for possible LDAP error code values.

Error Messages

    The following message may be set from this function.
    CPF3CF2 E  Error(s) occurred during running of ldap_simple_bind_s API.

Related Information

    ldap_bind() -- Asynchronously bind to the directory (deprecated).
    ldap_bind_s() -- Synchronously bind to the directory (deprecated).
    ldap_sasl_bind() -- Asynchronously bind to the directory using SASL.
    ldap_sasl_bind_s() -- Synchronously bind to the directory using SASL.
    ldap_simple_bind() -- Asynchronously bind to the directory using simple authentication.
    ldap_unbind() -- Asynchronously unbind from the LDAP server and close the connection.
    ldap_unbind_s() -- Synchronously unbind from the LDAP server and close the connection.
    ldap_set_rebind_proc() -- Sets the entry-point of a routine during the chasing of referrals.