fonction ldap_modify_extW (winldap.h)

2024-11-20

La fonction ldap_modify_ext modifie une entrée existante.

Syntaxe

WINLDAPAPI ULONG LDAPAPI ldap_modify_extW(
  [in]  LDAP          *ld,
  [in]  const PWSTR   dn,
  [in]  LDAPModW * [] mods,
  [in]  PLDAPControlW *ServerControls,
  [in]  PLDAPControlW *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 de l’entrée à modifier.

[in] mods

Tableau de modifications terminée par null à apporter à l’entrée.

[in] ServerControls

Liste des contrôles serveur LDAP.

[in] ClientControls

Liste des contrôles clients

[out] MessageNumber

Ce paramètre de résultat est défini sur l’ID de message de la demande si l’appel réussit.

Valeur de retour

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_ext lance une opération asynchrone 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 les valeurs sont supprimées et qu’aucune valeur n’est conservée, la fonction supprime l’attribut. Toutes les modifications sont effectuées dans l’ordre dans lequel elles sont répertoriées.

Les paramètres et les effets de ldap_modify_ext sous-énumération de ceux de ldap_modify. 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.

Si elle réussit, ldap_modify_ext renvoie l’ID de message de l’opération dans le paramètre MessageNumber. Appelez ldap_result avec l’ID de message pour obtenir le résultat de l’opération. Si vous préférez que la fonction retourne directement le résultat, utilisez la fonction étendue synchrone ldap_modify_ext_s.

Multithreading : les appels à ldap_modify_ext sont thread-safe.

Note

L’en-tête winldap.h définit ldap_modify_ext en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
serveur minimum pris en charge	Windows Server 2008
plateforme cible	Windows
d’en-tête	winldap.h
bibliothèque	Wldap32.lib
DLL	Wldap32.dll