Class ContactGuid

class ContactGuid;

Description

A globally unique identifier enquiry utility.

Each contact item has a unique identifier, stored as a descriptor. It is referred to as the 'UID string'. This is a combination of the unique identifier of the database in which the contact item was created, the contact item ID and the date/time of the contact item's creation. ContactGuid provides a single static exported function to enquire whether an item was created in a specified database.

Members

Defined in ContactGuid:
IsLocalContactUidString()

static IMPORT_C TContactItemId IsLocalContactUidString(const TDesC &aString, TInt64 aMachineUniqueId);

Description

Tests whether a contact item was created in the database with the unique ID specified. If so, the item's contact item ID is returned. If not, returns KErrNotFound.

Parameters

const TDesC &aString The contact item's UID string. Use CContactItem::UidStringL() to get a pointer to the item's UID string. TInt64 aMachineUniqueId The database's unique ID. This can be found by calling CContactDatabase::MachineId().

Return value

TContactItemId KErrNotFound if the database ID specified is not found in the UID string. Otherwise, the contact item's contact item ID.