ldap_rename_ext_sW-Funktion (winldap.h)
Die ldap_rename_ext_s-Funktion ist ein synchroner Vorgang, der den distinguishierten Namen eines Eintrags im Verzeichnis ändert. Diese Funktion ist mit LDAP 3 verfügbar.
WINLDAPAPI ULONG LDAPAPI ldap_rename_ext_sW(
[in] LDAP *ld,
[in] const PWSTR dn,
[in] const PWSTR NewRDN,
[in] const PWSTR NewParent,
[in] INT DeleteOldRdn,
[in] PLDAPControlW *ServerControls,
[in] PLDAPControlW *ClientControls
);
[in] ld
Das Sitzungshandle.
[in] dn
Ein Zeiger auf eine breite, mit Null beendete Zeichenfolge, die den distinguishierten Namen des eintrags enthält, der umbenannt werden soll.
[in] NewRDN
Ein Zeiger auf eine breite, mit Null beendete Zeichenfolge, die den neuen relativen Distinguished Name enthält.
[in] NewParent
Ein Zeiger auf eine breite, mit Null beendete Zeichenfolge, die den distinguishierten Namen des neuen übergeordneten Elements für diesen Eintrag enthält. Mit diesem Parameter können Sie den Eintrag in einen neuen übergeordneten Container verschieben.
[in] DeleteOldRdn
TRUE, wenn der alte relative Unterscheidungsname gelöscht werden soll; FALSE, wenn der alte relative Unterscheidungsname beibehalten werden soll.
[in] ServerControls
Liste der LDAP-Serversteuerelemente.
[in] ClientControls
Liste der Clientsteuerelemente.
Wenn die Funktion erfolgreich ist, wird der Rückgabewert LDAP_SUCCESS.
Wenn die Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Rückgabewerte.
Multithreading: Aufrufe von ldap_rename_ext_s sind threadsicher.
Hinweis
Der winldap.h-Header definiert ldap_rename_ext_s als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows Vista |
mindestens unterstützte Server- | Windows Server 2008 |
Zielplattform- | Fenster |
Header- | winldap.h |
Library | Wldap32.lib |
DLL- | Wldap32.dll |