ldap_modify_s-Funktion (winldap.h)

Artikel
03/04/2024

Die ldap_modify_s-Funktion ändert einen vorhandenen Eintrag.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_modify_s(
  [in] LDAP          *ld,
  [in] PSTR          dn,
  [in] LDAPModA * [] mods
);

Parameter

[in] ld

Das Sitzungshandle.

[in] dn

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des zu ändernden Eintrags enthält.

[in] mods

Ein Array mit NULL-Beendigung von Änderungen, die am Eintrag vorgenommen werden sollen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert LDAP_SUCCESS.

Wenn die Ausführung der Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Zurückgeben von Werten .

Hinweise

Die ldap_modify_s-Funktion initiiert einen synchronen Vorgang, um einen vorhandenen Eintrag zu ändern. Wenn Werte im Eintrag hinzugefügt oder im Eintrag ersetzt werden, erstellt die Funktion ggf. das -Attribut. Wenn Werte gelöscht werden, entfernt die Funktion das Attribut, wenn keine Werte verbleiben. Alle Änderungen werden in der Reihenfolge durchgeführt, in der sie aufgelistet sind.

Multithreading: Aufrufe von ldap_modify_s sind threadsicher.

Hinweis Beim Herstellen einer Verbindung mit einem LDAP 2-Server muss die Anwendung einen Bindungsvorgang (durch Aufrufen einer der ldap_bind oder ldap_simple_bind Routinen) ausführen, bevor sie andere Vorgänge versucht.

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