ldap_rename_ext-Funktion (winldap.h)

2023-08-27

Die ldap_rename_ext-Funktion startet einen asynchronen Vorgang, der den distinguished Name eines Eintrags im Verzeichnis ändert. Diese Funktion ist ab LDAP 3 verfügbar.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_rename_ext(
  [in]  LDAP          *ld,
  [in]  const PSTR    dn,
  [in]  const PSTR    NewRDN,
  [in]  const PSTR    NewParent,
  [in]  INT           DeleteOldRdn,
  [in]  PLDAPControlA *ServerControls,
  [in]  PLDAPControlA *ClientControls,
  [out] ULONG         *MessageNumber
);

Parameter

[in] ld

Das Sitzungshandle.

[in] dn

Ein Zeiger auf eine breite Zeichenfolge mit NULL-Beendigung, die den distinguished Name des umzubenennten Eintrags enthält.

[in] NewRDN

Ein Zeiger auf eine breite NULL-Zeichenfolge, die den neuen relativen Distinguished-Namen für den Eintrag enthält.

[in] NewParent

Ein Zeiger auf eine breite NULL-Zeichenfolge, die den distinguished Name 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 Distinguished Name gelöscht werden soll; FALSE , wenn der alte relative distinguished Name beibehalten werden soll.

[in] ServerControls

Liste der LDAP-Serversteuerelemente.

[in] ClientControls

Liste der Clientsteuerelemente.

[out] MessageNumber

Zeiger auf eine Variable, die den Nachrichtenbezeichner für diesen asynchronen Vorgang empfängt. Verwenden Sie diesen Bezeichner mit der ldap_result-Funktion , um die Ergebnisse des Vorgangs abzurufen.

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

Diese Funktion bietet erweiterte Umbenennungsvorgänge. Sie können z. B. Steuerelemente übergeben, die das übergeordnete Element vom relativen distinguished-Namen trennen.

Multithreading: Aufrufe an ldap_rename_ext sind threadsicher.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	winldap.h
Bibliothek	Wldap32.lib
DLL	Wldap32.dll

Weitere Informationen

Erweiterte Steuerelemente

Funktionen

Ändern eines Verzeichniseintrags

Verwenden von Steuerelementen

Freigeben über