Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die ldap_add_ext_s-Funktion initiiert einen synchronen Vorgang zum Hinzufügen einer Struktur. 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).
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_add_ext_s(
[in] LDAP *ld,
[in] const PSTR dn,
[in] LDAPModA * [] attrs,
[in] PLDAPControlA *ServerControls,
[in] PLDAPControlA *ClientControls
);
Parameter
[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. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
[in] ServerControls
Eine Liste der LDAP-Serversteuerelemente.
[in] ClientControls
Eine Liste der Clientsteuerelemente.
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 Rückgabewerte.
Hinweise
Zu den Parametern und Effekten von ldap_add_ext_s gehören die Parameter ldap_add_s. Die erweiterte Routine enthält zusätzliche Parameter zur Unterstützung von Client- und Serversteuerelementen.
Erstellen Sie vor dem Aufrufen ldap_add_ext_s einen Eintrag, indem Sie dessen Attribute in LDAPMod-Strukturen angeben. Legen Sie den mod_op Member der einzelnen Strukturen auf LDAP_MOD_ADD fest, und legen Sie die mod_type und mod_vals entsprechend Ihrem Eintrag fest.
Nach Abschluss des Add-Vorgangs kehrt ldap_add_ext_s zum Aufrufer zurück. Verwenden Sie ldap_add_ext , wenn Sie den Vorgang lieber asynchron abschließen möchten.
Multithreading: Aufrufe an ldap_add_ext_s sind threadsicher.
Hinweis Beim Herstellen einer Verbindung mit einem LDAP 2-Server muss die Anwendung einen Bindungsvorgang ausführen, indem sie eine der ldap_bind oder ldap_simple_bind Routinen aufruft, 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 |