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