Windows Contacts

Overview of the Windows Contacts technology.

To develop Windows Contacts, you need these headers:

• icontact.h

For programming guidance for this technology, see:

• Windows Contacts

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.