ldap_start_tls_app_np()--Start a TLS Session with an Application ID
Syntax
#include <ldap.h>
int ldap_start_tls_app_np(
LDAP
*ld,
const char
*applicationID)
Library Name/Service Program: QSYS/QGLDCLNT
Default Public Authority: *USE
Threadsafe: Yes
The ldap_start_tls_app_np() function is used to secure a previously unsecured connection. It takes a handle from an existing LDAP connection and the name of the application ID to use. If the command is successful, then communication on the connection will be secure until either the connection is closed or an ldap_stop_tls_s_np() call is made.
The secure environment must be initialized by calling ldap_ssl_client_init() or ldap_ssl_environment_init().
Authorities and Locks
Read, *R, authority is needed to the system certificate store. Execute, *X, authority is needed to the associated directories.
Parameters
ld
(Input) Specifies the LDAP pointer returned by a previous call to ldap_init(). Must not be NULL.
applicationID
(Input) Specifies the name of the application ID to use and may be NULL.
If NULL, the QIBM_GLD_DIRSRV_CLIENT application ID will be used.