ldap_addW-Funktion (winldap.h)

2024-11-20

Die ldap_add-Funktion initiiert einen asynchronen Add-Vorgang zu einer Verzeichnisstruktur. Damit ein Add-Vorgang erfolgreich ausgeführt werden kann, muss das übergeordnete Element des hinzugefügten Eintrags vorhanden sein, oder das übergeordnete Element muss leer sein (gleich dem distinguishierten Namen des Stamms).

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_addW(
  [in] LDAP          *ld,
  [in] PWSTR         dn,
  [in] LDAPModW * [] attrs
);

Parameter

[in] ld

Das Sitzungshandle.

[in] dn

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den distinguishierten Namen 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 Nachrichten-ID des Add-Vorgangs zurückgegeben.

Wenn die Funktion fehlschlägt, wird –1 zurückgegeben und die Sitzungsfehlerparameter in der LDAP- Datenstruktur festgelegt. Verwenden Sie LdapGetLastError-, um die Fehlerdaten abzurufen.

Bemerkungen

Erstellen Sie vor dem Aufrufen ldap_addeinen Eintrag, indem Sie ihre Attribute in LDAPMod- Strukturen angeben. Legen Sie das mod_op Element jeder Struktur auf LDAP_MOD_ADD fest, und legen Sie die elemente mod_type und mod_vals entsprechend für Ihren 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_abandonauf.

Damit die Ergebnisse direkt zurückgegeben werden, verwenden Sie die synchrone Funktion ldap_add_s. Verwenden Sie ldap_add_ext oder ldap_add_ext_s, um 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 -1 Fehlercode zurückgibt.

Hinweis Beim Herstellen einer Verbindung mit einem LDAP 2-Server muss die Anwendung einen Bindungsvorgang ausführen, indem eine der ldap_bind oder ldap_simple_bind Routinen aufgerufen wird, bevor sie andere Vorgänge ausführen.

Anmerkung

Der winldap.h-Header definiert ldap_add als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
mindestens unterstützte Server-	Windows Server 2008
Zielplattform-	Fenster
Header-	winldap.h
Library	Wldap32.lib
DLL-	Wldap32.dll