ldap_app_ssl_start_np()--Start a Secure LDAP Connection using DCM

Syntax #include <ldap.h> #include <ldapssl.h> int ldap_app_ssl_start_np(LDAP *ld, char *dcm_identifier) Threadsafe: Yes

The ldap_app_ssl_start_np() function is used to start a secure connection (using Secure Sockets Layer (SSL)) to an LDAP server using the Digital Certificate Manager (DCM) to control the digital certificate.

ldap_app_ssl_start_np() must be called after ldap_open() and prior to ldap_bind(). Once the secure connection is established for the ld, all subsequent LDAP messages that flow over the secure connection are encrypted, including the ldap_bind() parameters, until ldap_unbind() is called.

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().

dcm_identifier

(Input) an identifier string which corresponds to a secure application registered with DCM.

Return Value

LDAP_SUCCESS

if the request was successful.

another LDAP error code

if the request was not successful.

Error Conditions

If ldap_app_ssl_start_np() will return LDAP error code if not successful. 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_app_ssl_start_np API.

Related Information

    ldap_ssl_init() -- Initializes an SSL connection.
    ldap_ssl_start() -- Creates a secure SSL connection.
    ldap_bind() -- bind to the directory server.
    ldap_unbind() -- unbind from the LDAP server and close the connection.
    ldap_open() -- Open a connection to an LDAP server.