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_modrdn-Funktion ändert den relativen Distinguished-Namen eines LDAP-Eintrags.
Diese Funktion ist veraltet und wird aus Gründen der Abwärtskompatibilität mit früheren LDAP-Versionen bereitgestellt. Verwenden Sie für LDAP 3 oder höher die funktionen ldap_rename_ext oder ldap_rename_ext_s .
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_modrdn(
[in] LDAP *ExternalHandle,
[in] const PSTR DistinguishedName,
[out] const PSTR NewDistinguishedName
);
Parameter
[in] ExternalHandle
Das Sitzungshandle.
[in] DistinguishedName
Ein Zeiger auf eine NULL-Zeichenfolge, die den distinguished Name des zu ändernden Eintrags enthält.
[out] NewDistinguishedName
Ein Zeiger auf eine NULL-Zeichenfolge, die den neuen relativen Distinguished-Namen enthält, um den Eintrag zu geben.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie die Nachrichten-ID des Änderungsvorgangs zurück.
Wenn die Funktion fehlschlägt, gibt sie –1 zurück und legt die Sitzungsfehlerparameter in der LDAP-Datenstruktur fest.
Hinweise
Verwenden Sie die ldap_modrdn-Funktion oder ihre synchrone Entsprechung ldap_modrdn_s, um den Namen eines LDAP-Eintrags zu ändern. LDAP 2 unterstützt zusätzliche Features über ldap_modrdn2 und ldap_modrdn2_s.
Als asynchrone Funktion gibt ldap_modrdn 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 Add-Vorgang abzubrechen, bevor er abgeschlossen ist, rufen Sie ldap_abandon auf.
Beachten Sie, dass die verschiedenen ldap_modrdn-Funktionen es Ihnen ermöglichen, nur den relativen distinguished-Namen zu ändern, der die am wenigsten signifikante Komponente des distinguished Namens des Objekts ist. Ab Version 3 stellt LDAP den Protokollvorgang Modify Distinguished Name (Distinguished Name ändern) bereit, der einen allgemeineren Zugriff auf Namensänderungen ermöglicht. Dieses Feature ist durch Aufrufen von ldap_rename_ext oder ldap_rename_ext_s verfügbar. Diese Funktionen werden empfohlen, anstelle der ldap_modrdn-Funktion einen Eintragsnamen zu ändern.
Multithreading: Aufrufe von ldap_modrdn sind threadsicher, sofern LdapGetLastError verwendet wird, um den tatsächlichen Sitzungsfehlercode abzurufen, wenn der Funktionsaufruf den Fehlercode -1 zurückgibt.
Hinweis Beim Herstellen einer Verbindung mit einem LDAP 2-Server muss die Anwendung einen Bindungsvorgang ausführen, indem sie eine der ldap_bind - oder ldap_simple_bind-Routinen aufruft, bevor sie andere Vorgänge versucht.
ldap_modrdn ist veraltet und wird ausschließlich aus Gründen der Kompatibilität mit LDAP 1-Implementierungen bereitgestellt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | winldap.h |
| Bibliothek | Wldap32.lib |
| DLL | Wldap32.dll |