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-Namen 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_modrdn2A(
[in] LDAP *ExternalHandle,
[in] const PSTR DistinguishedName,
[in] const PSTR NewDistinguishedName,
[in] INT DeleteOldRdn
);
Parameter
[in] ExternalHandle
Das Sitzungshandle.
[in] DistinguishedName
Eine NULL-Zeichenfolge, die den zu ändernden Distinguished-Namen enthält.
[in] NewDistinguishedName
Eine NULL-Zeichenfolge, die den neuen relativen Distinguished-Namen enthält, der dem Eintrag zu geben ist.
[in] DeleteOldRdn
TRUE , wenn der alte relative Distinguished Name gelöscht werden soll; FALSE , wenn der alte relative distinguished Name beibehalten werden soll.
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_modrdn2-Funktion oder deren 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. 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 bedeutende 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 die Namensänderung ermöglicht. Diese Funktionalität ist verfügbar, indem Sie ldap_rename_ext oder ldap_rename_ext_s aufrufen. 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 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.
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 |