Auf Englisch lesen

Freigeben über


ldap_add-Funktion (winldap.h)

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

Siehe auch

Funktionen

LDAP

LDAPMod

Ändern eines Verzeichniseintrags

Synchrone und asynchrone Aufrufe

ldap_abandon

ldap_add_ext

ldap_add_ext_s

ldap_add_s

ldap_bind

ldap_result

ldap_simple_bind