Edit

Share via


Windows Contacts

Overview of the Windows Contacts technology.

To develop Windows Contacts, you need these headers:

For programming guidance for this technology, see:

Functions

 
CommitChanges

Saves changes made to this contact to the contact file.
CreateArrayNode

Creates a new array node in a multi-value property.
DeleteArrayNode

Deletes the data at a specified array entry.
DeleteLabels

Deletes the labels at a specified array entry.
DeleteProperty

Deletes the value at a specified property. Property modification and version data can still be enumerated with IContactPropertyCollection.
GetBinary

Retrieves the binary data of a property using an IStream interface [Structured Storage].
GetContactCollection

Returns an IContactCollection object that contains all known contacts.
GetContactID

Retrieves the local computer unique contact ID.
GetCurrent

Retrieves the current contact in the enumeration.
GetDate

Retrieves the date and time value at a specified property into a caller's FILETIME structure. All times are stored and returned as Coordinated Universal Time (UTC).
GetLabels

Retrieves the labels for a specified array element name.
GetMeContact

Retrieves the local user account concept of 'me'.
GetPath

Retrieves the file system path used to load this contact.
GetPropertyArrayElementID

Retrieves the unique ID for a given element in a property array.
GetPropertyCollection

Returns an IContactPropertyCollection for the current contact. Optionally, filters the IContactPropertyCollection to enumerate only some values.
GetPropertyModificationDate

Retrieves the last modification date for the current property in the enumeration. If not modified, contact creation date is returned.
GetPropertyName

Retrieves the name for the current property in the enumeration.
GetPropertyType

Retrieves the type for the current property in the enumeration.
GetPropertyVersion

Retrieves the version number for the current property in the enumeration.
GetString

Retrieves the string value at a specified property into a caller-allocated buffer.
Initialize

Initializes the contact manager with the unique application name and application version being used to manipulate contacts.
Load

Loads an IContact object with the data from the contact referenced by the computer-local contact ID.
MergeContactIDs

Makes an old Contact ID resolve to the same value as a new Contact ID. Subsequent calls to IContactManager::Load with the old contact ID now loads the new contact ID contact.
Next

Moves to the next contact.
Next

Moves to the next property.
Reset

Resets the enumerator to before the logical first element.
Reset

Resets enumeration of properties.
SetBinary

Sets the binary data at a specified property to the contents of a specified IStream interface [Structured Storage], which contains a null-terminated string (as MIME type) data.
SetDate

Sets the date and time value at a specified property to a given FILETIME. All times are stored and returned as Coordinated Universal Time (UTC).
SetLabels

Appends the set of labels passed in to the specified property's label set. Note:_This method does not check for duplicate labels.
SetMeContact

Sets the local user account concept of 'me' to specified user.
SetString

Sets the string value of a specified property to that of a specified null-terminated string.

Interfaces

 
IContact

Do not use. Defines methods for reading and writing properties for a single contact.
IContactCollection

Do not use. Enumerates the contacts known by the IContactManager.
IContactManager

Do not use. Used for retrieving a contact, based on a contact ID string.
IContactProperties

Do not use. Used to retrieve, set, create, and remove properties on an IContact. Property names and extension mechanisms are described in icontactproperties.h.
IContactPropertyCollection

Do not use. Used to filter contact data, based on a label or property set. Enumerates contact properties exposed with an IContactProperties object. For each property, the name, type, version, and modification date can be retrieved.