fonction ldap_add (winldap.h)

Article
08/27/2023

La fonction ldap_add lance une opération d’ajout asynchrone à une arborescence de répertoires. Pour qu’une opération d’ajout réussisse, le parent de l’entrée ajoutée doit exister ou le parent doit être vide (égal au nom unique de la racine).

Syntaxe

WINLDAPAPI ULONG LDAPAPI ldap_add(
  [in] LDAP         *ld,
  [in] PSTR         dn,
  [in] LDAPMod * [] attrs
);

Paramètres

[in] ld

Handle de session.

[in] dn

Pointeur vers une chaîne terminée par null qui contient le nom unique de l’entrée à ajouter.

[in] attrs

Tableau de pointeurs vers des structures LDAPMod . Chaque structure spécifie un attribut unique.

Valeur retournée

Si la fonction réussit, l’ID de message de l’opération d’ajout est retourné.

Si la fonction échoue, elle retourne –1 et définit les paramètres d’erreur de session dans la structure de données LDAP . Pour récupérer les données d’erreur, utilisez LdapGetLastError.

Remarques

Avant d’appeler ldap_add, créez une entrée en spécifiant ses attributs dans les structures LDAPMod . Définissez le membre mod_op de chaque structure sur LDAP_MOD_ADD, puis définissez les membres mod_type et mod_vals en fonction de votre entrée.

En tant que fonction asynchrone, ldap_add retourne un ID de message pour l’opération. Appelez ldap_result avec l’ID de message pour obtenir le résultat de l’opération. Pour annuler une opération d’ajout asynchrone avant qu’elle ne soit terminée, appelez ldap_abandon.

Pour que les résultats soient retournés directement, utilisez la fonction synchrone ldap_add_s. Utilisez ldap_add_ext ou ldap_add_ext_s pour activer la prise en charge des contrôles client et serveur LDAP 3.

Multithreading : les appels à ldap_add sont thread-safe, à condition que LdapGetLastError soit utilisé pour récupérer le code d’erreur de session réel lorsque l’appel de fonction retourne le code d’échec -1.

Note Lors de la connexion à un serveur LDAP 2, l’application doit effectuer une opération de liaison, en appelant l’une des routines ldap_bind ou ldap_simple_bind , avant d’essayer d’autres opérations.

Configuration requise


Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	winldap.h
Bibliothèque	Wldap32.lib
DLL	Wldap32.dll