ldap_next_reference-Funktion (winldap.h)

Die ldap_next_reference-Funktion ruft einen Verweis aus einer Suchergebniskette ab.

Syntax

WINLDAPAPI LDAPMessage *LDAPAPI ldap_next_reference(
  [in] LDAP        *ld,
  [in] LDAPMessage *entry
);

Parameter

[in] ld

Das Sitzungshandle.

[in] entry

Der Eintrag, der von einem vorherigen Aufruf von ldap_first_reference oder ldap_next_reference zurückgegeben wurde.

Rückgabewert

Wenn die Suche gültige Ergebnisse zurückgegeben hat, gibt diese Funktion einen Zeiger auf den nächsten Ergebniseintrag im Resultset zurück. Wenn keine weiteren Einträge oder Verweise im Resultset vorhanden sind, 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_next_reference in Verbindung mit ldap_first_reference , um schrittweise eine Liste mit Fortsetzungsverweise aus einer Suchergebniskette abzurufen.

Die Funktion gibt untergeordnete Verweise (Verweise) zurück, die in Suchantworten zurückgegeben werden. Eine untergeordnete Empfehlung ist eine, bei der der Server einige Daten zurückgegeben hat und die Empfehlung an andere Benennungskontexte unterhalb der aktuellen Ebene in der Struktur übergeben wurde. Verwenden Sie ldap_parse_result, um externe Verweise zu durchlaufen, in denen sich der Benennungskontext nicht auf dem Server befindet.

Sie müssen den zurückgegebenen Verweis nicht explizit freigeben, da er freigegeben wird, wenn die Nachricht selbst freigegeben wird.

Anforderungen

Siehe auch

Funktionen

ldap_first_reference

ldap_parse_result