ldap_add_ext_s-Funktion (winldap.h)

Artikel
03/04/2024

Die ldap_add_ext_s-Funktion initiiert einen synchronen Vorgang zum Hinzufügen einer Struktur. Damit ein Add-Vorgang erfolgreich ist, muss das übergeordnete Element des hinzugefügten Eintrags vorhanden sein, oder das übergeordnete Element muss leer sein (gleich dem Distinguished Name des Stamms).

Syntax

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

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

Eine Liste der LDAP-Serversteuerelemente.

[in] ClientControls

Eine Liste der Clientsteuerelemente.

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 Rückgabewerte.

Hinweise

Zu den Parametern und Effekten von ldap_add_ext_s gehören die Parameter ldap_add_s. Die erweiterte Routine enthält zusätzliche Parameter zur Unterstützung von Client- und Serversteuerelementen.

Erstellen Sie vor dem Aufrufen ldap_add_ext_s einen Eintrag, indem Sie dessen Attribute in LDAPMod-Strukturen angeben. Legen Sie den mod_op Member der einzelnen Strukturen auf LDAP_MOD_ADD fest, und legen Sie die mod_type und mod_vals entsprechend Ihrem Eintrag fest.

Nach Abschluss des Add-Vorgangs kehrt ldap_add_ext_s zum Aufrufer zurück. Verwenden Sie ldap_add_ext , wenn Sie den Vorgang lieber asynchron abschließen möchten.

Multithreading: Aufrufe an ldap_add_ext_s 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