Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Location: cntitem.h
Link against: cntmodel.lib

Class ContactGuid

ContactGuid

Support

Supported from 5.1

Description

Globally unique identifier enquiry. Each contact item has a unique identifier, stored as a descriptor. It is referred to as the "UID string". It 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. This class provides a single static exported function to enquire whether an item was created in a specified database.

Defined in ContactGuid:
IsLocalContactUidString()


IsLocalContactUidString()

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