LdapNewEntry

Syntax

LdapNewEntry(connName, dn);

connName

The identifier specified in the LdapConnect call.

dn

The distinguished name of the new object (entry) to be created. For example, the distinguished name might consist of the objects uid, ou, and o. Note that the parameters must be given in exact order from the leaf entry to the root entry. o is the first level or root level to be specified, i.e. the organization to which the object belongs, ou is the second level, i.e. the group to which the object belongs, and the uid is the ID of the specific user or object. In this example, the o and ou objects must have been created prior to this function call. The new entry created will contain the unique attribute uid and become a leaf entry in the directory tree.

Description

Creates a new entry in the LDAP directory. Changes are not written to the directory until the LdapUpdateEntry function is called.

Returns

entryID	An entryID is returned if the new entry was created successfully. The entryID can be used with subsequent calls to access entry attributes.
""	An empty string is returned if the search fails.

Example

$theuser=ldapNewEntry("con","uid=123456, ou=People,dc=streamserve,dc=com");

In this example a new entry is created and the value is assigned to the theuser variable. The theuser entry contains the value of the distinguished name of the object (in this case we may assume that the object is a new user). The distinguished name consists of the following components: user ID, organization unit (group), and the organization that the user belongs to.