ldap_add_extW-Funktion (winldap.h)

2024-11-20

Die ldap_add_ext-Funktion initiiert einen asynchronen Add-Vorgang zu einer Struktur. Das übergeordnete Element des hinzugefügten Eintrags muss vorhanden sein, oder das übergeordnete Element muss leer (gleich dem distinguished name of the root) sein, damit ein Add-Vorgang erfolgreich ausgeführt werden kann.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_add_extW(
  [in]  LDAP          *ld,
  [in]  const PWSTR   dn,
  [in]  LDAPModW * [] attrs,
  [in]  PLDAPControlW *ServerControls,
  [in]  PLDAPControlW *ClientControls,
  [out] ULONG         *MessageNumber
);

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. Weitere Informationen finden Sie im Abschnitt "Hinweise".

[in] ServerControls

Liste der LDAP-Serversteuerelemente.

[in] ClientControls

Liste der Clientsteuerelemente.

[out] MessageNumber

Die Nachrichten-ID für die Anforderung.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird LDAP_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Fehlerbehandlung.

Bemerkungen

Die Parameter und Effekte von ldap_add_ext umfassen die Parameter ldap_add. Die erweiterte Routine enthält zusätzliche Parameter zur Unterstützung von Client- und Serversteuerelementen und Threadsicherheit.

Erstellen Sie vor dem Aufrufen ldap_add_exteinen Eintrag, indem Sie die Attribute in LDAPMod- Strukturen angeben. Legen Sie das mod_op Feld jeder Struktur auf LDAP_MOD_ADDfest, und legen Sie die Felder mod_type und mod_vals entsprechend für den Eintrag fest.

Wenn der Vorgang erfolgreich ist, übergibt ldap_add_ext die Nachrichten-ID als Parameter an den Aufrufer. Rufen Sie ldap_result mit der Nachrichten-ID auf, um das Ergebnis des Vorgangs zu erhalten.

Damit die Ergebnisse direkt zurückgegeben werden, verwenden Sie die synchrone Funktion ldap_add_ext_s.

Multithreaded: Aufrufe von ldap_add_ext sind threadsicher.

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.

ServerControls und ClientControls optional und sollten auf NULL- festgelegt werden, wenn sie nicht verwendet werden.

Anmerkung

Der winldap.h-Header definiert ldap_add_ext 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