ldap_rename_extA-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_extA(
  [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, mit NULL endende Zeichenfolge, die den distinguished Name des umzubenennten Eintrags enthält.

[in] NewRDN

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

[in] NewParent

Ein Zeiger auf eine breite, NULL-endende 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 funktion ldap_result , 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 Zurückgeben von Werten .

Hinweise

Diese Funktion stellt erweiterte Umbenennungsvorgänge bereit. Sie können z. B. Steuerelemente übergeben, die das übergeordnete Element vom relativen distinguished Name trennen, um die Übersichtlichkeit zu erhöhen.

Multithreading: Aufrufe von 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