ldap_modify_extW-Funktion (winldap.h)

2024-11-20

Die ldap_modify_ext-Funktion ändert einen vorhandenen Eintrag.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_modify_extW(
  [in]  LDAP          *ld,
  [in]  const PWSTR   dn,
  [in]  LDAPModW * [] mods,
  [in]  PLDAPControlW *ServerControls,
  [in]  PLDAPControlW *ClientControls,
  [out] ULONG         *MessageNumber
);

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.

[in] ServerControls

Eine Liste der LDAP-Serversteuerelemente.

[in] ClientControls

Eine Liste der Clientsteuerelemente

[out] MessageNumber

Dieser Ergebnisparameter wird auf die Nachrichten-ID der Anforderung festgelegt, wenn der Aufruf erfolgreich ist.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Rückgabewerte.

Bemerkungen

Die ldap_modify_ext-Funktion initiiert einen asynchronen Vorgang zum Ändern eines vorhandenen Eintrags. Wenn werte im Eintrag 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.

Die Parameter und Effekte von ldap_modify_ext subsumieren diejenigen von ldap_modify. Die erweiterte Routine enthält zusätzliche Parameter zur Unterstützung von Client- und Serversteuerelementen sowie Threadsicherheit.

Bei erfolgreicher Ausführung übergibt ldap_modify_ext die Nachrichten-ID für den Vorgang im MessageNumber-Parameter zurück. Rufen Sie ldap_result mit der Nachrichten-ID auf, um das Ergebnis des Vorgangs abzurufen. Wenn Sie es vorziehen, das Ergebnis direkt zurückzugeben, verwenden Sie die synchrone erweiterte Funktion ldap_modify_ext_s.

Multithreading: Aufrufe von ldap_modify_ext sind threadsicher.

Anmerkung

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