ldap_first_attribute-Funktion (winldap.h)
Für einen angegebenen Verzeichniseintrag gibt die funktion ldap_first_attribute das erste Attribut zurück.
Syntax
WINLDAPAPI PCHAR LDAPAPI ldap_first_attribute(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[out] BerElement **ptr
);
Parameter
[in] ld
Das Sitzungshandle.
[in] entry
Der Eintrag, dessen Attribute wie von ldap_first_entry oder ldap_next_entry zurückgegeben werden sollen.
[out] ptr
Die Adresse eines Zeigers, der intern zum Nachverfolgen der aktuellen Position im Eintrag verwendet wird.
Rückgabewert
Ein Zeiger auf eine NULL-endende Zeichenfolge. Wenn die Funktion erfolgreich ist, wird ein Zeiger auf einen zugeordneten Puffer zurückgegeben, der den aktuellen Attributnamen enthält. Wenn es keine weiteren Attribute gibt, die durchlaufen werden müssen, 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_first_attribute in Verbindung mit ldap_next_attribute , um die Liste der Attributtypen zu durchlaufen, die mit einem Eintrag zurückgegeben werden. Sie können diese Attributnamen dann in einem Aufruf von ldap_get_values übergeben, um die zugehörigen Werte abzurufen.
Ein Aufruf von ldap_first_attribute zugeordnet und gibt über den ptr-Parameter einen Zeiger auf eine BerElement-Struktur zurück. Übergeben Sie diesen Zeiger 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.
Sowohl ldap_first_attribute als auch ldap_next_attribute geben einen Zeiger auf einen 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 entweder ldap_first_attribute oder überschrieben wird
ldap_next_attribute sollte der Benutzer eine Kopie des Attributnamens erstellen, wenn er zur Verarbeitung beibehalten werden muss.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | winldap.h |
| Bibliothek | Wldap32.lib |
| DLL | Wldap32.dll |