ldap_modify_ext_s-Funktion (winldap.h)

Artikel
03/06/2024

Die ldap_modify_ext_s-Funktion ändert einen vorhandenen Eintrag.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_modify_ext_s(
  [in] LDAP          *ld,
  [in] const PSTR    dn,
  [in] LDAPModA * [] mods,
  [in] PLDAPControlA *ServerControls,
  [in] PLDAPControlA *ClientControls
);

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.

[in] ServerControls

Eine Liste der LDAP-Serversteuerelemente.

[in] ClientControls

Eine Liste der Clientsteuerelemente.

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 funktion ldap_modify_ext_s initiiert einen synchronen Vorgang, um einen vorhandenen Eintrag zu ändern. Wenn Werte im Eintrag hinzugefügt oder ersetzt werden, erstellt die Funktion ggf. das Attribut. Wenn Werte gelöscht werden und keine Werte verbleiben, entfernt die Funktion das Attribut. Alle Änderungen werden in der Reihenfolge durchgeführt, in der sie aufgelistet sind.

Die Parameter und Auswirkungen von ldap_modify_ext_s subsumieren die von ldap_modify_s. Die erweiterte Routine enthält zusätzliche Parameter zur Unterstützung von Client- und Serversteuerelementen.

Multithreading: Aufrufe von ldap_modify_ext_s sind threadsicher.

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