ldap_get_values-Funktion (winldap.h)
Die ldap_get_values-Funktion ruft die Liste der Werte eines angegebenen Attributs ab.
Syntax
WINLDAPAPI PCHAR *LDAPAPI ldap_get_values(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[in] const PSTR attr
);
Parameter
[in] ld
Das Sitzungshandle.
[in] entry
Der Eintrag, aus dem Werte abgerufen werden sollen.
[in] attr
Ein Zeiger auf eine NULL-endende Zeichenfolge, die das Attribut enthält, dessen Werte abgerufen werden sollen.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird eine NULL-endende Liste von Zeigern auf Werte zurückgegeben. Wenn keine Attributwerte gefunden wurden, wird normalerweise NULL zurückgegeben. In einigen Fällen kann jedoch eine Liste zurückgegeben werden, die null ist. Stellen Sie immer sicher, dass Sie ldap_count_values verwenden, um die Anzahl der Werte in der zurückgegebenen Liste abzurufen, wie in den Hinweisen erwähnt. Der Sitzungsfehlerparameter in der LDAP-Datenstruktur ist in beiden Fällen auf 0 festgelegt.
Wenn die Funktion fehlschlägt, wird NULL zurückgegeben, und der Sitzungsfehlerparameter in der LDAP-Datenstruktur wird auf den LDAP-Fehlercode festgelegt.
Hinweise
Verwenden Sie ldap_get_values , wenn Sie eine Suchantwort analysieren, um den Wert oder die Werte eines Attributs abzurufen. Verwenden Sie diese Funktion nur, wenn das Attribut Zeichenfolgen mit NULL-Beendigung enthält. Verwenden Sie für Binärdaten stattdessen ldap_get_values_len .
Der Eintrag wird durch Aufrufen von ldap_first_entry oder ldap_next_entry abgerufen. Das Attribut sollte durch einen Aufruf von ldap_first_attribute, ldap_next_attribute oder einer vom Aufrufer bereitgestellten Zeichenfolge (z. B. "mail") zurückgegeben werden.
Verwenden Sie ldap_count_values , um die Anzahl der Werte in der zurückgegebenen Liste abzurufen. Rufen Sie ldap_value_free auf, um den zurückgegebenen Wert freizugeben, wenn er nicht mehr benötigt wird.
Bestimmte LDAP-Server legen Grenzwerte für die Anzahl von Attributzeichenfolgenwerten fest, die in einem einzelnen Aufruf zurückgegeben werden. Weitere Informationen zur Verwendung von Bereichsabrufsspezifizierern finden Sie unter Suchen mithilfe des Bereichsabrufs.
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 |