ldap_modifyW-Funktion (winldap.h)

2024-11-20

Die ldap_modify-Funktion ändert einen vorhandenen Eintrag.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_modifyW(
  [in] LDAP          *ld,
  [in] PWSTR         dn,
  [in] LDAPModW * [] mods
);

Parameter

[in] ld

Das Sitzungshandle.

[in] dn

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen des zu ändernden Eintrags enthält.

[in] mods

Ein null-beendetes Array von Änderungen, die am Eintrag vorgenommen werden sollen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird die Nachrichten-ID des Änderungsvorgangs zurückgegeben.

Wenn die Funktion fehlschlägt, wird –1 zurückgegeben und die Sitzungsfehlerparameter in der LDAP- Datenstruktur festgelegt.

Bemerkungen

Die ldap_modify-Funktion initiiert einen asynchronen Vorgang zum Ändern eines vorhandenen Eintrags. Wenn dem Eintrag Werte hinzugefügt oder ersetzt werden, erstellt die Funktion das Attribut bei Bedarf. Wenn Werte gelöscht werden und keine Werte verbleiben, entfernt die Funktion das Attribut. Alle Änderungen werden in der Reihenfolge ausgeführt, in der sie aufgeführt werden.

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_abandonauf.

Wenn Sie die Ergebnisse lieber direkt zurückgeben möchten, 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 -1 Fehlercode 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 ausführen.

Anmerkung

Der winldap.h-Header definiert ldap_modify 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