Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die ldap_modify_s-Funktion ändert einen vorhandenen Eintrag.
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_modify_sW(
[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 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_s-Funktion initiiert einen synchronen Vorgang, um einen vorhandenen Eintrag zu ändern. Wenn dem Eintrag Werte hinzugefügt oder ersetzt werden, erstellt die Funktion das Attribut bei Bedarf. Wenn Werte gelöscht werden, entfernt die Funktion das Attribut, wenn keine Werte verbleiben. Alle Änderungen werden in der Reihenfolge ausgeführt, in der sie aufgeführt werden.
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 ausführen.
Anmerkung
Der winldap.h-Header definiert ldap_modify_s 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 |