Export (0) Print
Expand All
Expand Minimize

ldap_first_entry function

The ldap_first_entry function returns the first entry of a message.

Syntax


LDAPMessage* ldap_first_entry(
  _In_  LDAP *ld,
  _In_  LDAPMessage *res
);

Parameters

ld [in]

The session handle.

res [in]

The search result, as obtained by a call to one of the synchronous search routines or ldap_result.

Return value

If the search returned valid results, this function returns a pointer to the first result entry. If no entry or reference exists 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_first_entry in conjunction with ldap_next_entry to step through and retrieve the list of entries from a search result chain.

You do not have to explicitly free the returned entry as 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

Winldap.h

Library

Wldap32.lib

DLL

Wldap32.dll

See also

Functions
ldap_next_entry
ldap_result

 

 

Show:
© 2014 Microsoft