Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die ldap_get_values-Funktion ruft die Liste der Werte eines bestimmten Attributs ab.
Syntax
WINLDAPAPI PWCHAR *LDAPAPI ldap_get_valuesW(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[in] const PWSTR attr
);
Parameter
[in] ld
Das Sitzungshandle.
[in] entry
Der Eintrag, aus dem Werte abgerufen werden sollen.
[in] attr
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die das Attribut enthält, dessen Werte abgerufen werden sollen.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird eine Null-beendete Liste von Zeigern auf Werte zurückgegeben. Wenn keine Attributwerte gefunden wurden, wird in der Regel NULL-zurückgegeben. In einigen Fällen kann es jedoch einen Zeiger zurückgeben, der 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.
Bemerkungen
Verwenden Sie ldap_get_values beim Analysieren einer Suchantwort, um den Wert oder die Werte eines Attributs abzurufen. Verwenden Sie diese Funktion nur, wenn das Attribut null-beendete Zeichenfolgen enthält; verwenden Sie stattdessen ldap_get_values_len für Binärdaten.
Der Eintrag wird durch Aufrufen von ldap_first_entry oder ldap_next_entryabgerufen. Das Attribut sollte von einem Aufruf von ldap_first_attribute, ldap_next_attributeoder 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 erforderlich ist.
Bestimmte LDAP-Server legen Grenzwerte für die Anzahl der Attributzeichenfolgenwerte fest, die in einem einzelnen Aufruf zurückgegeben werden. Weitere Informationen zur Verwendung von Bereichsabrufbezeichnern finden Sie unter Suchen mithilfe von Bereichsabrufen.
Anmerkung
Der winldap.h-Header definiert ldap_get_values als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | winldap.h |
| Library | Wldap32.lib |
| DLL- | Wldap32.dll |