LDAPReplaceAttribute (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / LDAP functions

Differences between LDAPReplaceAttribute and LDAPReplaceAttributeValue
Modifying an existing object on an LDAP server

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

LDAP functions

LDAPReplaceAttribute (Function)

In french: LDAPRemplaceAttribut

Replaces all the values of an attribute by a specific value.

Example

// Modifie une valeur donnée d'un attribut 
// (la lecture sur le serveur a été effectuée précédemment)
// Les valeurs existantes sont dans les chaînes sValeur1, sValeur2 et sValeur3
// On veut remplacer sValeur2 par sNouvelleValeur
LDAPStartModify("NomSession")
LDAPReplaceAttribute("NomSession", "NomAttribut", sNouvelleValeur)
LDAPAddAttribute("NomSession", "NomAttribut", sValeur1)
LDAPAddAttribute("NomSession", "NomAttribut", sValeur3)
LDAPValidateModify("NomSession", "DN")

Syntax

<Result> = LDAPReplaceAttribute(<LDAP session> , <Attribute name> , <Attribute value>)

<Result>: Boolean

True if the modification was performed,
False otherwise. ErrorInfo returns more details about the error. The modification will be performed during the call to LDAPValidateModify.

<LDAP session>: Character string

Name of LDAP session used.

<Attribute name>: Character string

Name of attribute to use.

<Attribute value>: ANSI character string

New attribute value.

Remarks

Differences between LDAPReplaceAttribute and LDAPReplaceAttributeValue

LDAPReplaceAttribute is used to replace all the values of an attribute by a single value. A multi-valued attribute (several values for this attribute) will become a single-valued attribute (a single value for this attribute).

LDAPReplaceAttributeValue is used to replace a specific value of an attribute by a new value. A multi-valued attribute remains a multi-valued attribute.

Modifying an existing object on an LDAP server

To modify an existing object in an LDAP server, you must define the different modifications to perform.

To optimize object modification speed, modifications are defined locally: a single communication with the server is established when the modification is validated. The steps are:

Start modification (LDAPStartModify).
Modification operations:
- Add attributes and their values LDAPAddAttribute).
- Delete attributes (LDAPDeleteAttribute) or their values (LDAPDeleteAttributeValue).
- Replace values of an attribute (LDAPReplaceAttribute or LDAPReplaceAttributeValue)
- Rename attributes (LDAPRenameAttribute)
Validate the modifications on the server (LDAPValidateModify). The modifications are performed on the server according to the order used in the WLanguage code.

Please note As modification operations are performed locally before being transferred to the server, it is essential to respect the logical order of modifications (for example, it will not be possible to modify an attribute deleted by the previous line of code).

Component: wd300com.dll