ldap_add_ext-Funktion (winldap.h)

Artikel
08/27/2023

Die ldap_add_ext-Funktion initiiert einen asynchronen Vorgang zum Hinzufügen einer Struktur. Das übergeordnete Element des hinzugefügten Eintrags muss vorhanden sein, oder das übergeordnete Element muss leer sein (gleich dem distinguished name of the root), damit ein Add-Vorgang erfolgreich ist.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_add_ext(
  [in]  LDAP          *ld,
  [in]  const PSTR    dn,
  [in]  LDAPModA * [] attrs,
  [in]  PLDAPControlA *ServerControls,
  [in]  PLDAPControlA *ClientControls,
  [out] ULONG         *MessageNumber
);

Parameter

[in] ld

Das Sitzungshandle.

[in] dn

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den distinguished Name des hinzuzufügenden Eintrags enthält.

[in] attrs

Ein Array von Zeigern auf LDAPMod-Strukturen . Jede Struktur gibt ein einzelnes Attribut an. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

[in] ServerControls

Liste der LDAP-Serversteuerelemente.

[in] ClientControls

Liste der Clientsteuerelemente.

[out] MessageNumber

Die Nachrichten-ID für die Anforderung.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird LDAP_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Fehlerbehandlung.

Hinweise

Zu den Parametern und Effekten von ldap_add_ext gehören die Parameter ldap_add. Die erweiterte Routine enthält zusätzliche Parameter zur Unterstützung von Client- und Serversteuerungen sowie threadsicherheit.

Erstellen Sie vor dem Aufrufen ldap_add_ext einen Eintrag, indem Sie dessen Attribute in LDAPMod-Strukturen angeben. Legen Sie das mod_op Feld jeder Struktur auf LDAP_MOD_ADD fest, und legen Sie die felder mod_type und mod_vals entsprechend Ihrem Eintrag fest.

Wenn der Vorgang erfolgreich ist, übergibt ldap_add_ext die Nachrichten-ID als Parameter an den Aufrufer. Rufen Sie ldap_result mit der Nachrichten-ID auf, um das Ergebnis des Vorgangs zu erhalten.

Um die Ergebnisse direkt zurückzugeben, verwenden Sie die synchrone Funktion ldap_add_ext_s.

Multithreading: Aufrufe von ldap_add_ext sind threadsicher.

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.

ServerControls und ClientControls sind optional und sollten auf NULL festgelegt werden, wenn sie nicht verwendet werden.

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