Saving Contacts to Active Directory
Topic Last Modified: 2006-06-30
The Iperson.DataSource property returns the attached IDataSource interface. The IDataSource interface exposes the following four methods that save contacts to the Active Directory® directory service:
After you bind the contact to a data source, you can call the IDataSource.Save method to save changes to the bound data source. You can call the IDataSource.SaveTo method to bind to, and save data to, an existing item specified by a URL. To bind to, and save data to, a new item at a specified URL, you can call the IDataSource.SaveToContainer method. The IDataSource.SaveToObject method allows you to save data to another object at run time.
The LDAP binding string contains prefixes and distinguishing names that specify the position of the contact in the Active Directory hierarchy. Use the following prefixes: CN for common names, DC for domains, and O or OU for organizations. CN specifies the common name of the object and the classification of the object, such as users. Use as many DCs as necessary for each qualification in the domain name, including a DC for sub-domains.
Example
The following example shows how to create a contact and save it to Active Directory. The LDAP binding string contains the first and last names of the user, the classification of the user, and the domain of the server. The IDataSource.SaveTo method uses the LDAP binding string to save the contact to Active Directory.
Example
Visual Basic
'Declare variables
Dim iPer As New CDO.Person
Dim strLDAP As String
With iPer
'Set first and last names and company name
.FirstName = "Max"
.LastName = "Benson"
.Company = "Coho Winery"
'Indicate that this is a contact
.Fields("objectClass").Value = "contact"
'Save changes made to properties
.Fields.Update
End With
'Setup the LDAP string
strLDAP = "LDAP://servername/cn=Max Benson, cn=users, dc=domain, dc=com"
'Save the contact to Active Directory
iPer.DataSource.SaveTo strURL