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.
WINLDAPAPI ULONG LDAPAPI ldap_add_sA(
[in] LDAP *ld,
[in] PSTR dn,
[in] LDAPModA * [] attrs
);
[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.
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 .
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.
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 |