fonction ldap_add_ext (winldap.h)

Article
03/04/2024

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

Syntaxe

WINLDAPAPI ULONG LDAPAPI ldap_add_ext(
  [in]  LDAP          *ld,
  [in]  const PSTR    dn,
  [in]  LDAPModA * [] attrs,
  [in]  PLDAPControlA *ServerControls,
  [in]  PLDAPControlA *ClientControls,
  [out] ULONG         *MessageNumber
);

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.

[out] MessageNumber

ID de message de la demande.

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 Gestion des erreurs.

Remarques

Les paramètres et les effets de ldap_add_ext incluent ceux de ldap_add. La routine étendue inclut des paramètres supplémentaires pour prendre en charge les contrôles client et serveur et la sécurité des threads.

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

Si l’opération réussit, ldap_add_ext transmet l’ID de message à l’appelant en tant que paramètre. Appelez ldap_result avec l’ID de message pour obtenir le résultat de l’opération.

Pour que les résultats soient retournés directement, utilisez la fonction synchrone ldap_add_ext_s.

Multithread : les appels à ldap_add_ext 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