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 für die Abwärtskompatibilität mit früheren Versionen von LDAP 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_sW(
[in] LDAP *ExternalHandle,
[in] const PWSTR DistinguishedName,
[out] const PWSTR NewDistinguishedName
);
Parameter
[in] ExternalHandle
Das Sitzungshandle.
[in] DistinguishedName
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den distinguishierten Namen des zu ändernden Eintrags enthält.
[out] NewDistinguishedName
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den neuen relativen Distinguished-Namen enthält, um den Eintrag anzugeben.
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
Verwenden Sie die ldap_modrdn_s-Funktion oder die 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 Name zu ändern, der die am wenigsten signifikante Komponente des distinguished-Namens des Objekts ist. Ab Version 3 stellt LDAP den Modify Distinguished Name-Protokollvorgang bereit, der den Zugriff auf die allgemeine Namensänderung ermöglicht. Dieses Feature ist durch Aufrufen von ldap_rename_ext oder ldap_rename_ext_sverfügbar. Diese Funktionen werden anstelle der ldap_modrdn_s Funktion empfohlen, einen Eintragsnamen zu ändern.
Anmerkung
Der winldap.h-Header definiert ldap_modrdn_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 |