LDAPAddAttribute (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

Adding a new object into an LDAP server

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

LDAPAddAttribute (Function)

In french: LDAPAjouteAttribut

Adds an attribute or adds a new value to an existing attribute.

This function can be used when creating a new object and when modifying an object in an LDAP server.

Example

// Ajout d'un utilisateur Test dans un "Active Directory"
LDAPStartAdd("MaSessionLDAP")
LDAPAddAttribute("MaSessionLDAP", "objectClass", "top")
LDAPAddAttribute("MaSessionLDAP", "objectClass", "person")
LDAPAddAttribute("MaSessionLDAP", "objectClass", "organizationalPerson")
LDAPAddAttribute("MaSessionLDAP", "objectClass", "user")
LDAPAddAttribute("MaSessionLDAP", "objectCategory", ...
	"CN=Person,CN=Schema,CN=Configuration,DC=societe,DC=fr")
LDAPAddAttribute("MaSessionLDAP", "instanceType", "4")
LDAPAddAttribute("MaSessionLDAP", "cn","Test")
LDAPAddAttribute("MaSessionLDAP", "sAMAccountName", "Test")
LDAPValidateAdd("MaSessionLDAP", "cn=Test,cn=Users,dc=societe,dc=fr")

// Ajoute une valeur à un attribut. Si l'attribut n'existe pas, il est créé. 
// La valeur est ajoutée aux valeurs existantes pour cet attribut
// La nouvelle valeur est dans la chaîne sNouvelleValeur
LDAPStartModify("NomSession")
LDAPAddAttribute("NomSession", "NomAttribut", sNouvelleValeur)
LDAPValidateModify("NomSession", "DN")

Syntax

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

<Result>: Boolean

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

<LDAP session>: Character string

Name of LDAP session used.

<Attribute name>: Character string

Name of the attribute to add. This attribute is automatically added if it does not exist.

<Attribute value>: ANSI character string

Value of the added attribute or new value of the attribute.
Note For some attributes (defined by the LDAP server schema), it is possible to have several values for the same attribute. The new value will be added if a value already exists for this attribute.

Remarks

Adding a new object into an LDAP server

To add a new object into an LDAP server, you must define the different attributes of this object as well as their values.

To optimize object creation speed, attributes and their values are defined locally: a single communication with the server is established during validation of the addition. The steps are:

Initialize the addition (LDAPStartAdd)
Add attributes and their values (LDAPAddAttribute). This operation can be performed as many times as necessary.
Associate the attributes and their values with an object using LDAPValidateAdd.

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 line of code).
To add an attribute on a "user" of the Active Directory, the attribute must have been declared beforehand in the parameters of the Active Directory as an attribute that can be exploited in the LDAP database.

Component: wd300com.dll