Uses the specified URL to perform an asynchronous search operation.
#include <ldap.h> int ldap_url_search ( LDAP *ld, const char *url, int attrsonly);
(IN) Points to the handle for the LDAP session.
(IN) Points to the URL to use in the search operation.
(IN) Specifies whether attribute values are returned with the specified attributes.
0—return attributes and values
1—return only attributes
Returns the message ID of the search operation.
To check the results of the operation, use the ldap_result or the ldap_result2error function.
Server timeouts and size limits for this function are set using the LDAP_OPT_TIMELIMIT and LDAP_OPT_SIZELIMIT options on the LDAP handle. This function has no client time or size limits.
An LDAP URL has the following format:
ldap[s]://<hostname>:<port>/<base_dn>?<attributes>?<scope>? <filter>?<extensions>
The following examples illustrate this URL format:
ldap://acme.com/ou=sales,o=acme?sn,telephoneNumber?sub? (objectclass=inetOrgPerson)?ext1=value1,ext2=value2
ldaps://1.2.3.4:636/o=novell??one