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).
WINLDAPAPI ULONG LDAPAPI ldap_add(
[in] LDAP *ld,
[in] PSTR dn,
[in] LDAPMod * [] attrs
);
[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.
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.
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.
Unterstützte Mindestversion (Client) | Windows Vista |
Unterstützte Mindestversion (Server) | Windows Server 2008 |
Zielplattform | Windows |
Kopfzeile | winldap.h |
Bibliothek | Wldap32.lib |
DLL | Wldap32.dll |
Ändern eines Verzeichniseintrags