ldap_modify_s, fonction (winldap.h)

Article
03/04/2024

La fonction ldap_modify_s modifie une entrée existante.

Syntaxe

WINLDAPAPI ULONG LDAPAPI ldap_modify_s(
  [in] LDAP          *ld,
  [in] PSTR          dn,
  [in] LDAPModA * [] mods
);

Paramètres

[in] ld

Handle de session.

[in] dn

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

[in] mods

Tableau terminé par un caractère Null des modifications à apporter à l’entrée.

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

La fonction ldap_modify_s lance une opération synchrone pour modifier une entrée existante. Si des valeurs sont ajoutées ou remplacées dans l’entrée, la fonction crée l’attribut, si nécessaire. Si des valeurs sont supprimées, la fonction supprime l’attribut si aucune valeur n’est conservée. Toutes les modifications sont effectuées dans l’ordre dans lequel elles sont répertoriées.

Multithreading : les appels à ldap_modify_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 de tenter d’autres opérations.

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