ldap_modrdn2-Funktion (winldap.h)

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_modrdn2(
  [in] LDAP       *ExternalHandle,
  [in] const PSTR DistinguishedName,
  [in] const PSTR NewDistinguishedName,
  [in] INT        DeleteOldRdn
);

Parameter

[in] ExternalHandle

Das Sitzungshandle.

[in] DistinguishedName

Eine null-endende Zeichenfolge, die den zu ändernden Distinguished Name enthält.

[in] NewDistinguishedName

Eine NULL-endende Zeichenfolge, die den neuen relativen Distinguished-Namen enthält, um den Eintrag zu erhalten.

[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 Meldungs-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 funktion ldap_modrdn2 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 signifikante Komponente des Distinguished-Namens des Objekts ist. Ab Version 3 stellt LDAP den Protokollvorgang Modify Distinguished Name (Distinguished Name ändern) bereit, der allgemeineren Zugriff auf Namensänderungen ermöglicht. Diese Funktionalität ist durch Aufrufen von ldap_rename_ext oder ldap_rename_ext_s verfügbar. Diese Funktionen werden anstelle der ldap_modrdn2-Funktion empfohlen, um 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

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

Ändern eines Verzeichniseintrags

ldap_abandon

ldap_modrdn2_s

ldap_rename_ext

ldap_rename_ext_s

ldap_result