IContactProperties Interface

Article
03/10/2009

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

IContactProperties Members

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].

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.

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

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

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 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.

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

Interface Information

Stock Implementation wab32.dll version 6.0 or later

Custom Implementation No

Inherits from IUnKnown

Header and IDL files contact.h, icontact.idl

Minimum operating systems Windows Vista

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].
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.
GetPropertyCollection	Returns an IContactPropertyCollection for the current contact. Optionally, filters the IContactPropertyCollection to enumerate only some values.
GetString	Retrieves the string value at a specified property into a caller-allocated buffer.
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 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.
SetString	Sets the string value of a specified property to that of a specified null-terminated string.

Stock Implementation	wab32.dll version 6.0 or later
Custom Implementation	No
Inherits from	IUnKnown
Header and IDL files	contact.h, icontact.idl
Minimum operating systems	Windows Vista

IContactProperties Interface

Additional resources