LdapReplaceAttrValue

Syntax

LdapReplaceAttrValue(entryID, attrName, value);

entryID	The identifier of an entry.
attrName	The name of the attribute whose set of values is to be replaced.
value	The new value to replace the existing value(s).

Description

Replaces the value(s) of an attribute with another value.

Note:

All values of the attribute named in attrName are removed and replaced by the value given in value. To add further values to an attribute you must use the LdapAddAttrValue function. Changes are not written to the LDAP directory until the LdapUpdateEntry function is called.

Returns

	The values were replaced successfully. If the attribute does not already exist it is created.
-1	Error. The value could not be replaced.

Example

ldapReplaceAttrValue($theuser,"description",$insert);

In this example, the value of the description attribute in theuser entry is replaced by the value of the insert variable. For example, if the description attribute contains a list of the formats in which the user wants their invoices, and the insert variable contains the value fax, then all values in the list are removed and fax is added.