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 ]