ContactGuid Class Reference

class ContactGuid

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.

Member Functions Documentation

CreateGuidLC(const TDesC &, TContactItemId, TInt64)

HBufC * CreateGuidLC ( const TDesC & aCreationDate,
TContactItemId aId,
TInt64 aMachineUniqueId
) [static]

Parameters

const TDesC & aCreationDate
TContactItemId aId
TInt64 aMachineUniqueId

CreateGuidLC(const TTime &, TContactItemId, TInt64)

HBufC * CreateGuidLC ( const TTime & aCreationDate,
TContactItemId aId,
TInt64 aMachineUniqueId
) [static]

Parameters

const TTime & aCreationDate
TContactItemId aId
TInt64 aMachineUniqueId

CreateGuidLC(TContactItemId, TInt64)

HBufC * CreateGuidLC ( TContactItemId aId,
TInt64 aMachineUniqueId
) [static]

Parameters

TContactItemId aId
TInt64 aMachineUniqueId

GetCreationDate(TDes &, TInt64)

IMPORT_C TBool GetCreationDate ( TDes & aString,
TInt64 aMachineUniqueId
) [static]

Parameters

TDes & aString
TInt64 aMachineUniqueId

IsLocalContactUidString(const TDesC &, TInt64)

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

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