LDAPDeleteAttributeValue (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Modifying an existing object on an LDAP server

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

LDAP functions

LDAPDeleteAttributeValue (Function)

In French: LDAPSupprimeValeurAttribut

Deletes a value of a specified attribute.

Example

// Delete a specific value
// The read operation was already performed on the LDAP server
// The value to delete is found in the sValueToDelete string
LDAPStartModify("SessionName")
LDAPDeleteAttributeValue("SessionName", "AttributeName", sValueToDelete)
LDAPValidateModify("SessionName", "DN")

// Delete several specific values
// The read operation was already performed on the LDAP server
// The values to delete are found in sValueToDelete1 and sValueToDelete2
LDAPStartModify("SessionName")
LDAPDeleteAttributeValue("SessionName", "AttributeName", sValueToDelete1)
LDAPDeleteAttributeValue("SessionName", "AttributeName", sValueToDelete2)
LDAPValidateModify ("SessionName", "DN")

Syntax

<Result> = LDAPDeleteAttributeValue(<Session Name> , <Attribute Name> , <Attribute Value>)

<Result>: Boolean

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

<Session Name>: Character string (with quotes)

Name of LDAP session used.

<Attribute Name>: Character string (with quotes)

Name of attribute to use.

<Attribute Value>: Ansi character string (with quotes)

Value of attribute to delete.

Remarks

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 the modification speed of objects, the modifications are defined locally: a single communication is established with the server when validating the modification. The steps are as follows:

Initializing the modification (LDAPStartModify)
Modification operations:
- Adding the attributes and their values (LDAPAddAttribute).
- Deleting the attributes (LDAPDeleteAttribute) or their values (LDAPDeleteAttributeValue).
- Replacing the values of an attribute (LDAPReplaceAttribute or LDAPReplaceAttributeValue)
- Renaming the attribute (LDAPRenameAttribute)
Validate the modifications on the server (LDAPValidateModify). The modifications are performed on the server according to the order used in the WLanguage code.

Caution: These operations being performed locally then on the server, the logical order of the modifications must be respected (you cannot for example modify an attribute that was already deleted by the previous code line).

Related Examples:

Unit examples (WINDEV): The LDAP functions

[ + ] Using the WLanguage LDAP functions.
These functions are used to interact with the LDAP data, to view the content of any LDAP directory and to modify the LDAP data: LDAPConnect, LDAPListChildren, LDAPAdAttribute, LDAPDeleteAttributeValue, ...

Components

wd230com.dll