fonction ldap_add_s (winldap.h)

Article
08/27/2023

La fonction ldap_add_s lance une opération d’ajout synchrone qui ajoute une entrée à une arborescence. Le parent de l’entrée ajoutée doit déjà exister ou le parent doit être vide (égal au nom unique racine) pour qu’une opération d’ajout réussisse.

Syntaxe

WINLDAPAPI ULONG LDAPAPI ldap_add_s(
  [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 null de pointeurs vers les structures LDAPMod . Chaque structure spécifie un attribut unique. Pour plus d'informations, consultez la section Notes.

Valeur retournée

Si la fonction réussit, la valeur de retour est LDAP_SUCCESS.

Si la fonction échoue, elle retourne un code d'erreur. Pour plus d’informations, consultez Valeurs de retour .

Remarques

Avant d’appeler ldap_add_s. vous devez créer 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. Pour plus d’informations, consultez Modification d’une entrée d’annuaire .

Une fois l’opération d’ajout terminée, ldap_add_s retourne à l’appelant. Utilisez ldap_add si vous préférez que l’opération soit effectuée de manière asynchrone.

Multithreading : les appels à ldap_add_s sont thread-safe.

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