Platform SDK: Active Directory, ADSI, and Directory Services |
The ldap_search_init_page function initializes a search block for a simple paged-results search. This function is supported in LDAP 3.
PLDAPSearch ldap_search_init_page( PLDAP ExternalHandle, PCHAR DistinguishedName, ULONG ScopeOfSearch, PCHAR SearchFilter, PCHAR AttributeList[], ULONG AttributesOnly, PLDAPControl* ServerControls, PLDAPControl* ClientControls, ULONG PageTimeLimit, ULONG TotalSizeLimit, PLDAPSortKey* SortKeys );
If the function succeeds, it returns a pointer to an LDAPSearch structure.
If the function fails, the return value is NULL. Use LdapGetLastError or GetLastError to retrieve the error code.
Call ldap_search_init to begin a paged-results search. When the function returns, use the returned handle to call.
To determine whether a server supports paged-results searches, check the supportedControl property off of the root for an object identifier (OID) of 1.2.840.113556.1.4.319.
Windows NT/2000: Requires Windows NT 4.0 SP4 or later.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in Winldap.h.
Library: Use Wldap32.lib.
Unicode: Declared as Unicode and ANSI prototypes.
Functions, GetLastError, LdapGetLastError LDAPSearch ldap_search_abandon_page LDAPSortKey