ldap_first_reference-Funktion (winldap.h)
Die ldap_first_reference-Funktion gibt den ersten Verweis aus einer Nachricht zurück.
Syntax
WINLDAPAPI LDAPMessage *LDAPAPI ldap_first_reference(
[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 Ergebnisverweis 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_reference in Verbindung mit ldap_next_reference , um eine Liste der Fortsetzungsverweise aus einer Suchergebniskette schrittweise zu durchlaufen und 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 stattdessen 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
| 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 |