ldap_next_entry function
The ldap_next_entry function retrieves an entry from a search result chain.
Syntax
LDAPMessage* ldap_next_entry( _In_ LDAP *ld, _In_ LDAPMessage *entry );
Parameters
- ld [in]
-
The session handle.
- entry [in]
-
The entry returned by a previous call to ldap_first_entry or ldap_next_entry.
Return value
If the search returned valid results, this function returns a pointer to the next result entry in the results set. If no further entries or references exist in the result set, it returns NULL. This is the only error return; the session error parameter in the LDAP data structure is cleared to 0 in either case.
Remarks
Use ldap_next_entry in conjunction with ldap_first_entry to step through and retrieve the list of entries from a search result chain.
You are not required to explicitly free the returned entry because it is freed when the message itself is freed.
Requirements
|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server | Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
Send comments about this topic to Microsoft
Build date: 10/26/2012
