ldap_modrdn_sA-Funktion (winldap.h)
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 .
WINLDAPAPI ULONG LDAPAPI ldap_modrdn_sA(
[in] LDAP *ExternalHandle,
[in] const PSTR DistinguishedName,
[out] const PSTR NewDistinguishedName
);
[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.
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.
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.
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 |