ldap_first_entry-Funktion (winldap.h)
Die funktion ldap_first_entry gibt den ersten Eintrag einer Nachricht zurück.
Syntax
WINLDAPAPI LDAPMessage *LDAPAPI ldap_first_entry(
[in] LDAP *ld,
[in] LDAPMessage *res
);
Parameter
[in] ld
Das Sitzungshandle.
[in] res
Das Suchergebnis, das durch einen Aufruf einer der synchronen Suchroutinen oder ldap_result abgerufen wird.
Rückgabewert
Wenn die Suche gültige Ergebnisse zurückgegeben hat, gibt diese Funktion einen Zeiger auf den ersten Ergebniseintrag zurück. Wenn im Resultset kein Eintrag oder Verweis vorhanden ist, wird NULL zurückgegeben. Dies ist die einzige Fehlerrückgabe. Der Sitzungsfehlerparameter in der LDAP-Datenstruktur wird in beiden Fällen auf 0 gelöscht.
Hinweise
Verwenden Sie ldap_first_entry in Verbindung mit ldap_next_entry , um die Liste der Einträge aus einer Suchergebniskette schrittweise zu durchlaufen und abzurufen.
Sie müssen den zurückgegebenen Eintrag nicht explizit freigeben, da er freigegeben wird, wenn die Nachricht selbst freigegeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | winldap.h |
| Bibliothek | Wldap32.lib |
| DLL | Wldap32.dll |