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 .

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

Siehe auch

Funktionen

ldap_modrdn

ldap_modrdn2

ldap_modrdn2_s

ldap_rename_ext

ldap_rename_ext_s