LDAPAPIInfoW structure (winldap.h)
The LDAPAPIInfo structure retrieves data about the API and implementations used.
Syntax
typedef struct ldapapiinfoW {
int ldapai_info_version;
int ldapai_api_version;
int ldapai_protocol_version;
PWCHAR *ldapai_extensions;
PWCHAR ldapai_vendor_name;
int ldapai_vendor_version;
} LDAPAPIInfoW;
Members
ldapai_info_version
The version of this structure, which must be set to LDAP_API_INFO_VERSION before a call to ldap_get_option.
ldapai_api_version
The current revision number of this LDAP API library.
ldapai_protocol_version
The latest LDAP version supported by this LDAP API library.
ldapai_extensions
Pointer to an array of null-terminated strings that indicate what API extensions are supported.
ldapai_vendor_name
Pointer to a null-terminated string that contains the name of the API vendor. This implementation returns the string ""Microsoft Corporation."".
ldapai_vendor_version
The API vendor version number. This implementation returns an integer value in the format of MMnn, where MM is the major version number * 100, and nn is the minor version number. For example, version 5.10 is returned as 510.
Remarks
A pointer to this structure is passed with the LDAP_OPT_API_INFO session option, to ldap_get_option, to retrieve data about this LDAP API library. The data returned includes a list of any API extensions supported by the implementation. When the structure data is no longer required, the caller must free the individual strings and string arrays returned in this structure by using the ldap_memfree and ldap_value_free functions.
Note
The winldap.h header defines LDAPAPIInfo as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista |
Minimum supported server | Windows Server 2008 |
Header | winldap.h |