- Adding a new object into an LDAP server
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.
// Add a Test user into an "Active Directory"
LDAPAddAttribute("MyLDAPSession", "objectClass", "top")
LDAPAddAttribute("MyLDAPSession", "objectClass", "person")
LDAPAddAttribute("MyLDAPSession", "objectClass", "organizationalPerson")
LDAPAddAttribute("MyLDAPSession", "objectClass", "user")
LDAPAddAttribute("MyLDAPSession", "objectCategory", ...
LDAPAddAttribute("MyLDAPSession", "instanceType", "4")
LDAPAddAttribute("MyLDAPSession", "cn", "Test")
LDAPAddAttribute("MyLDAPSession", "sAMAccountName", "Test")
// Adds a value to an attribute. The attribute is created if it does not exist.
// The value is added to the existing values for this attribute
// The new value is found in sNewValue
LDAPAddAttribute("SessionName", "AttributeName", sNewValue)
<Result> = LDAPAddAttribute(<LDAP session> , <Attribute name> , <Attribute value>)
The actual addition will be performed during the call to LDAPValidateAdd or to LDAPValidateModify.
- True if the addition was performed,
- False otherwise. ErrorInfo returns more details about the error.
<LDAP session>: Character string (with quotes)
Name of LDAP session used.
<Attribute name>: Character string (with quotes)
Name of the attribute to add. This attribute is automatically added if it does not exist.
<Attribute value>: Ansi character string (with quotes)
Value of the added attribute or new value of the attribute.
Remark: For some attributes (defined by the diagram of the LDAP server), several values can be defined for the same attribute. The new value will be added if a value already exists for this attribute.
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 the creation speed of objects, the attributes and their values are defined locally: a single communication is established with the server when validating the addition. The steps are:
- Initialize the addition (LDAPStartAdd)
- Add the attributes and their values (LDAPAddAttribute). This operation can be performed as many times as necessary.
- Associate the attributes and their values with an object (LDAPValidateAdd.
- 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).
- 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.
This page is also available for…