ldap_next_attribute-Funktion (winldap.h)
Für einen bestimmten Eintrag gibt die ldap_next_attribute-Funktion das nächste Attribut zurück.
Syntax
WINLDAPAPI PCHAR LDAPAPI ldap_next_attribute(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[in, out] BerElement *ptr
);
Parameter
[in] ld
Das Sitzungshandle.
[in] entry
Der Eintrag, dessen Attribute von ldap_first_entry oder ldap_next_entry zurückgegeben werden sollen.
[in, out] ptr
Die Adresse eines Zeigers, der intern zum Nachverfolgen der aktuellen Position im Eintrag verwendet wird.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie einen Zeiger auf eine NULL-Zeichenfolge zurück, die den aktuellen Attributnamen enthält. Wenn keine weiteren Attribute mehr vorhanden sind, wird NULL zurückgegeben. Der Sitzungsfehlerparameter in der LDAP-Datenstruktur ist in beiden Fällen auf 0 festgelegt.
Wenn die Funktion fehlschlägt, gibt sie NULL zurück und legt den Sitzungsfehlerparameter in der LDAP-Datenstruktur auf den LDAP-Fehlercode fest.
Hinweise
Verwenden Sie ldap_next_attribute in Verbindung mit ldap_first_attribute , um die Liste der Attributtypen zu durchlaufen, die mit einem Eintrag zurückgegeben werden. Sie können diese Attributnamen dann in einem Aufruf an ldap_get_values übergeben, um die zugeordneten Werte abzurufen.
Ein Aufruf von ldap_next_attribute gibt über den ptr-Parameter einen Zeiger auf eine BerElement-Struktur zurück. Übergeben Sie diesen Zeiger an den nächsten Aufruf an ldap_next_attribute , um die aktuelle Position in der Liste der Attribute nachzuverfolgen. Wenn Sie das Durchlaufen einer Liste von Attributen abgeschlossen haben und ptr nicht NULL ist, geben Sie den Zeiger frei, indem Sie ber_free (ptr, 0) aufrufen. Beachten Sie, dass Sie den zweiten Parameter in diesem Aufruf als 0 (null) übergeben müssen.
Die ldap_next_attribute-Funktion gibt einen Zeiger auf einen intern zugeordneten Puffer zurück, der den aktuellen Attributnamen enthält. Geben Sie diesen Puffer frei, wenn sie nicht mehr benötigt wird, indem Sie ldap_memfree aufrufen. Da dieser Puffer beim nächsten Aufruf von ldap_first_attribute oder ldap_next_attribute überschrieben wird, sollte der Benutzer eine Kopie des Attributnamens erstellen, wenn er für die Verarbeitung beibehalten werden muss.
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 |