Platform SDK: Exchange 2000 Server

IPerson Interface

[This is preliminary documentation and subject to change.]

Manage a contact who may have an Exchange Server mailbox.

IID
CD000127-8B95-11D1-82DB-00C04FB1625D
Extends
IDispatch

Member Summary

Properties

Name Type Description
Company

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the company name of the person contact.
Configuration

IConfiguration

IConfiguration*

A reference to a Configuration object that defines the configuration information used by the object.
DataSource

IDataSource

[C++,IDL]IDataSource*

Returns the IDataSource interface on the object.
Email

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the primary email address of the person contact.
Email2

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the secondary email address of the person contact.
Email3

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the tertiary email address of the person contact.
EmailAddresses

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains a list of valid email addresses of the person contact.
Fields

[Visual Basic,VBScript] Fields

[C++,IDL] Fields*

Returns the ADO Fields object for the person contact.
FileAs

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Defines how to display the person contact.
FileAsMapping

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Defines how to construct what is displayed for the person contact.
FirstName

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the first name of the person contact.
HomeCity

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the name of the home city for the person contact.
HomeCountry

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the name of the home country for the person contact.
HomeFax

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the home fax number for the person contact.
HomePhone

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the home telephone number for the person contact.
HomePostalAddress

(Read-only)

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the home postal address street number for the person contact.
HomePostalCode

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the home postal code (zip code in the US) for the person contact.
HomePostOfficeBox

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the post office box number for the person contact.
HomeState

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the home state for the person contact.
HomeStreet

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the home street for the person contact.
Initials

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the initials of the person contact.
LastName

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the last name of the person contact.
MailingAddress

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the postal mailing address for the person contact.
MailingAddressID

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Identifies which address is the mailing address for the person contact.
MiddleName

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the middle name of the person contact.
MobilePhone

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the mobile telephone number for the person contact.
NamePrefix

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the title to precede the name of the person contact.
NameSuffix

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the title to follow the name of the person contact.
Title

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the job title for the person contact.
WorkCity

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the work city for the person contact.
WorkCountry

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the work country for the person contact.
WorkFax

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the work fax number for the person contact.
WorkPager

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the work pager number for the person contact.
WorkPhone

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the work telephone number for the person contact.
WorkPostalAddress

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the work postal address street number for the person contact.
WorkPostalCode

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the work postal code (zip code in the US) for the person contact.
WorkPostOfficeBox

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the work post office box number for the person contact.
WorkState

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the work state for the person contact.
WorkStreet

[Visual Basic,VBScript] String

[C++,IDL] BSTR

Contains the work street for the person contact.

Methods

Name Description
GetInterface Returns the specified interface on the person contact. Acts as a QueryInterface or Set method for script languages.
GetVCardStream Obtains a VCard Stream object on the person contact.

Remarks

Use the IPerson interface to create an individual contact. Contacts are different from recipients since contacts do not appear in an address book.

If you regularly send mail to an individual, you should create an address entry for that individual using the IAddressee.

Example

[Visual Basic]
Dim p As New CDO.Person
p.DataSource.Open (addr, Nothing)
Dim MB As CDO.IMailbox
Dim myContacts As CDO.Folder

' Bind Mailbox to user's URL
p.DataSource.Open ("mailto:Someone@Somewhere.microsoft.com", Nothing)

' Set some properties for the contact
p.FirstName = "Some"
p.LastName = "One"
p.WorkStreet = "One Microsoft Way"
p.WorkCity = "Redmond"
p.WorkState = "WA"
p.Email = "SomeoneElse@SomewhereElse.microsoft.com"
p.WorkPhone = "425-882-8080"

' Get IMailbox IF on person
MB = p
myContacts = MB.Contacts
    
' Now save the new contact in the contacts folder
p.DataSource.SaveTo (myContacts.DataSource.SourceURL, Nothing)