ldap_add-Funktion (winldap.h)

2023-08-27

Die ldap_add-Funktion initiiert einen asynchronen Vorgang zum Hinzufügen einer Verzeichnisstruktur. 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(
  [in] LDAP         *ld,
  [in] PSTR         dn,
  [in] LDAPMod * [] attrs
);

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.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird die Meldungs-ID des Add-Vorgangs zurückgegeben.

Wenn die Funktion fehlschlägt, gibt sie –1 zurück und legt die Sitzungsfehlerparameter in der LDAP-Datenstruktur fest. Verwenden Sie LdapGetLastError, um die Fehlerdaten abzurufen.

Hinweise

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

Als asynchrone Funktion gibt ldap_add eine Nachrichten-ID für den Vorgang zurück. Rufen Sie ldap_result mit der Nachrichten-ID auf, um das Ergebnis des Vorgangs zu erhalten. Um einen asynchronen Add-Vorgang abzubrechen, bevor er abgeschlossen wurde, rufen Sie ldap_abandon auf.

Um die Ergebnisse direkt zurückzugeben, verwenden Sie die synchrone Funktion ldap_add_s. Verwenden Sie ldap_add_ext oder ldap_add_ext_s , um die Unterstützung für LDAP 3-Server- und Clientsteuerelemente zu aktivieren.

Multithreading: Aufrufe von ldap_add sind threadsicher, sofern LdapGetLastError verwendet wird, um den tatsächlichen Sitzungsfehlercode abzurufen, wenn der Funktionsaufruf den Fehlercode -1 zurückgibt.

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.

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