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_s-Funktion initiiert einen synchronen Add-Vorgang, der einen Eintrag zu einer Struktur hinzufügt. Das übergeordnete Element des hinzugefügten Eintrags muss bereits vorhanden sein, oder das übergeordnete Element muss leer sein (gleich dem Stammnamen), damit ein Add-Vorgang erfolgreich ausgeführt wird.
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_add_sW(
[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 null-beendetes Array von Zeigern auf LDAPMod- Strukturen. Jede Struktur gibt ein einzelnes Attribut an. Weitere Informationen finden Sie in den Hinweisen.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert LDAP_SUCCESS.
Wenn die Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Rückgabewerte.
Bemerkungen
Vor dem Aufrufen ldap_add_s. Sie müssen einen Eintrag erstellen, indem Sie seine 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. 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 die asynchrone Durchführung des Vorgangs bevorzugen.
Multithreading: Aufrufe von ldap_add_s sind threadsicher.
Hinweis Beim Herstellen einer Verbindung mit einem LDAP 2-Server muss die Anwendung einen Bindungsvorgang (durch Aufrufen einer der ldap_bind oder ldap_simple_bind Routinen) ausführen, bevor sie andere Vorgänge ausführen.
Anmerkung
Der winldap.h-Header definiert ldap_add_s 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 |