ldap_get_values_len-Funktion (winldap.h)
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 |