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_modrdn2-Funktion ändert den relativen Distinguished Name eines LDAP-Eintrags.
Diese Funktion ist veraltet. Verwenden Sie für LDAP 3 oder höher die funktionen ldap_rename_ext oder ldap_rename_ext_s.
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_modrdn2W(
[in] LDAP *ExternalHandle,
[in] const PWSTR DistinguishedName,
[in] const PWSTR NewDistinguishedName,
[in] INT DeleteOldRdn
);
Parameter
[in] ExternalHandle
Das Sitzungshandle.
[in] DistinguishedName
Eine mit Null beendete Zeichenfolge, die den zu ändernden Distinguished Name enthält.
[in] NewDistinguishedName
Eine mit Null beendete Zeichenfolge, die den neuen relativen Distinguished Name enthält, um den Eintrag anzugeben.
[in] DeleteOldRdn
TRUE, wenn der alte relative Unterscheidungsname gelöscht werden soll; FALSE, wenn der alte relative Unterscheidungsname beibehalten werden soll.
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
Verwenden Sie die ldap_modrdn2-Funktion oder die synchrone Entsprechung ldap_modrdn2_s, um den Namen eines LDAP-Eintrags zu ändern.
Als asynchrone Funktion gibt ldap_modrdn2 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. Rufen Sie ldap_abandonauf, um einen asynchronen Add-Vorgang abzubrechen, bevor er abgeschlossen ist.
Beachten Sie, dass die verschiedenen ldap_modrdn-Funktionen es Ihnen ermöglichen, nur den relativen Distinguished-Namen zu ändern, was die am wenigsten signifikante Komponente des distinguished-Namens des Objekts ist. Ab Version 3 bietet LDAP den Modify Distinguished Name-Protokollvorgang, der den allgemeinen Namensänderungszugriff ermöglicht. Diese Funktionalität ist durch Aufrufen von ldap_rename_ext oder ldap_rename_ext_sverfügbar. Diese Funktionen werden empfohlen, anstelle der ldap_modrdn2-Funktion einen Eintragsnamen zu ändern.
Multithreading: Aufrufe von ldap_modrdn2 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 ausführen, indem eine der ldap_bind oder ldap_simple_bind Routinen aufgerufen wird, bevor sie andere Vorgänge ausführen.
Anmerkung
Der winldap.h-Header definiert ldap_modrdn2 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 |