fonction ldap_add_ext_s (winldap.h)

Article
08/27/2023

La fonction ldap_add_ext_s lance une opération d’ajout synchrone à une arborescence. 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_ext_s(
  [in] LDAP          *ld,
  [in] const PSTR    dn,
  [in] LDAPModA * [] attrs,
  [in] PLDAPControlA *ServerControls,
  [in] PLDAPControlA *ClientControls
);

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. Pour plus d'informations, consultez la section Notes.

[in] ServerControls

Liste des contrôles serveur LDAP.

[in] ClientControls

Liste des contrôles clients.

Valeur retournée

Si la fonction réussit, LDAP_SUCCESS est retourné.

Si la fonction échoue, un code d’erreur est retourné. Pour plus d’informations, consultez Valeurs de retour.

Remarques

Les paramètres et les effets de ldap_add_ext_s incluent ceux de ldap_add_s. La routine étendue inclut des paramètres supplémentaires pour prendre en charge les contrôles client et serveur.

Avant d’appeler ldap_add_ext_s, 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.

Une fois l’opération d’ajout terminée, ldap_add_ext_s retourne à l’appelant. Utilisez ldap_add_ext si vous préférez que l’opération se termine de manière asynchrone.

Multithreading : les appels à ldap_add_ext_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.

ServerControls et ClientControls sont facultatifs et doivent être définis sur NULL s’ils ne sont pas utilisés.

Configuration requise

Condition requise	Valeur
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