Auf Englisch lesen

Freigeben über


ldap_add_sA-Funktion (winldap.h)

Die ldap_add_s-Funktion initiiert einen synchronen Add-Vorgang, der einer Struktur einen Eintrag hinzufügt. Das übergeordnete Element des hinzugefügten Eintrags muss bereits vorhanden sein, oder das übergeordnete Element muss leer sein (gleich dem distinguished root-Namen), damit ein Add-Vorgang erfolgreich ist.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_add_sA(
  [in] LDAP          *ld,
  [in] PSTR          dn,
  [in] LDAPModA * [] attrs
);

Parameter

[in] ld

Das Sitzungshandle.

[in] dn

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

[in] attrs

Ein Null-beendetes Array von Zeigern auf LDAPMod-Strukturen . Jede Struktur gibt ein einzelnes Attribut an. Weitere Informationen finden Sie unter Hinweise.

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

Hinweise

Bevor Sie ldap_add_s aufrufen. Sie müssen einen Eintrag erstellen, indem Sie seine 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 Member entsprechend Ihrem Eintrag fest. Weitere Informationen finden Sie unter Ändern eines Verzeichniseintrags .

Nach Abschluss des Add-Vorgangs kehrt ldap_add_s zum Aufrufer zurück. Verwenden Sie ldap_add , wenn Sie den Vorgang lieber asynchron ausführen lassen möchten.

Multithreading: Aufrufe an ldap_add_s sind threadsicher.

Hinweis Beim Herstellen einer Verbindung mit einem LDAP 2-Server muss die Anwendung einen Bindungsvorgang (durch Aufrufen einer der ldap_bind - oder ldap_simple_bind-Routinen ) ausführen, bevor sie andere Vorgänge versucht.
 

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

Siehe auch

Funktionen

LDAPMod

Ändern eines Verzeichniseintrags

Rückgabewerte

ldap_add

ldap_bind

ldap_simple_bind