ldap_modify-Funktion (winldap.h)

Artikel
08/27/2023

Die ldap_modify-Funktion ändert einen vorhandenen Eintrag.

Syntax

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

Parameter

[in] ld

Das Sitzungshandle.

[in] dn

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

[in] mods

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

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie die Nachrichten-ID des Änderungsvorgangs zurück.

Wenn die Funktion fehlschlägt, gibt sie –1 zurück und legt die Sitzungsfehlerparameter in der LDAP-Datenstruktur fest.

Hinweise

Die ldap_modify-Funktion initiiert einen asynchronen Vorgang zum Ändern eines vorhandenen Eintrags. Wenn Werte im Eintrag hinzugefügt oder ersetzt werden, erstellt die Funktion das Attribut, falls erforderlich. Wenn Werte gelöscht werden und keine Werte mehr vorhanden sind, entfernt die Funktion das Attribut. Alle Änderungen werden in der Reihenfolge ausgeführt, in der sie aufgelistet sind.

Als asynchrone Funktion gibt ldap_modify eine Nachrichten-ID für den Vorgang zurück. Rufen Sie ldap_result mit der Nachrichten-ID auf, um das Ergebnis des Vorgangs zu erhalten. Um einen asynchronen Vorgang abzubrechen, bevor er abgeschlossen ist, rufen Sie ldap_abandon auf.

Wenn Sie es vorziehen, dass die Funktion die Ergebnisse direkt zurückgibt, verwenden Sie die synchrone Routine ldap_modify_s. Verwenden Sie ldap_modify_ext oder ldap_modify_ext_s , wenn Sie Unterstützung für LDAP 3-Server- und Clientsteuerelemente benötigen.

Multithreading: Aufrufe von ldap_modify sind threadsicher, sofern LdapGetLastError verwendet wird, um den tatsächlichen Sitzungsfehlercode abzurufen, wenn der Funktionsaufruf den Fehlercode -1 zurückgibt.

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


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	winldap.h
Bibliothek	Wldap32.lib
DLL	Wldap32.dll