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_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 |