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_s-Funktion ändert den relativen distinguished Name 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 funktion ldap_rename_ext oder ldap_rename_ext_s .
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_modrdn_sA(
[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, wird der Rückgabewert LDAP_SUCCESS.
Wenn die Ausführung der Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Rückgabewerte.
Hinweise
Verwenden Sie die ldap_modrdn_s-Funktion oder deren asynchrone Entsprechung ldap_modrdn, um den Namen eines LDAP-Eintrags zu ändern. Diese Funktion bietet Kompatibilität mit LDAP 1. Verwenden Sie andernfalls ldap_modrdn2 oder ldap_modrdn2_s.
Beachten Sie, dass die 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_s-Funktion einen Eintragsnamen zu ändern.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista |
Unterstützte Mindestversion (Server) | Windows Server 2008 |
Zielplattform | Windows |
Kopfzeile | winldap.h |
Bibliothek | Wldap32.lib |
DLL | Wldap32.dll |