ldap_version -- Obtain LDAP Version and SSL Cipher Information

Syntax

 #include <ldap.h>
 #include <ldapssl.h>
 
 int ldap_version(
         LDAPVersion  *version )

  Default Public Authority: *USE

  Library Name/Service Program: QSYS/QGLDCLNT

  Threadsafe: Yes

The ldap_version() routine is used to return the toolkit version (multiplied by 100). It also sets information in the LDAPVersion structure.

Authorities and Locks

No IBM^® i authority is required.

Parameters

version

(Input) Specifies the address of an LDAPVersion structure that contains the following returned values:

sdk_version

Toolkit version, multiplied by 100.

protocol_version

Highest LDAP protocol supported, multiplied by 100.

SSL_version

SSL version supported, multiplied by 100.

security_level

Level of encryption supported, in bits. Set to LDAP_SECURITY_NONE if SSL not enabled.

ssl_max_cipher

A string containing the default ordered set of ciphers supported by this installation. See LDAP_OPT_SSL_CIPHER in ldap_set_option() for more information about changing the set of ciphers used to negotiate the secure connection with the server.

sdk_vendor

A pointer to a static string that identifies the supplier of the LDAP library. This string should not be freed by the application.

sdk_build_level

A pointer to a static string that identifies the build level, including the date when the library was built. This string should not be freed by the application.

Return Value

Software Developer Toolkit Version: Sets information in the LDAPVersion structure and return the SDK VERSION.

Error Conditions

The ldap_version() API does not return an error code.

Error Messages

The following message may be sent from this function.

Message ID

Error Message Text

CPF3CF2 E

Error(s) occurred during running of ldap_version API.

API introduced: V4R5

[ Back to top | LDAP APIs | APIs by category ]