ldap_get_values_len-Funktion (winldap.h)

2024-03-04

Die ldap_get_values_len-Funktion ruft die Liste der Werte für ein bestimmtes Attribut ab.

Syntax

WINLDAPAPI berval **LDAPAPI ldap_get_values_len(
  [in] LDAP        *ExternalHandle,
  [in] LDAPMessage *Message,
  [in] const PSTR  attr
);

Parameter

[in] ExternalHandle

Das Sitzungshandle.

[in] Message

Handle für die LDAPMessage-Struktur .

[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, gibt sie eine NULL-endende Liste von Zeigern auf berval-Strukturen zurück, die die Werte des angegebenen Attributs enthalten. Wenn keine Attributwerte gefunden wurden, wird NULL zurückgegeben. 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_len , wenn Sie eine Suchantwort analysieren, um den Wert oder die Werte eines Attributs abzurufen. Verwenden Sie diese Funktion, wenn das Attribut Binärdaten enthält. Verwenden Sie für Attribute, deren Werte NULL-endende Zeichenfolgen sind, ldap_get_values.

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.

Rufen Sie ldap_value_free_len auf, um den zurückgegebenen Wert freizugeben, wenn er nicht mehr benötigt 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