PR_ENTRYID 

The PR_ENTRYID property contains a MAPI entry identifier used to open and edit properties of a particular MAPI object.

Quick Info

Header file:

MAPITAGS.H

Must be exposed by:

Address book container, distribution list, folder, messaging user, message, message store, and status objects

Identifier:

0x0FFF

Property type:

PT_BINARY

Property tag:

0x0FFF0102

 

Remarks

The PR_ENTRYID property identifies an object for OpenEntry to instantiate and provides access to all of its properties through the appropriate derived interface of IMAPIProp.

PR_ENTRYID is one of the base address properties for all messaging users. For more information on the base address properties, see Base Address PropertiesN3YFFO.

PR_ENTRYID can contain either a long-term or a short-term identifier. Short-term identifiers are easier and faster to construct, but are limited in their scope and duration, typically to the current session and workstation. They are commonly used for objects of a temporary nature, such as table rows or dialog box entries, and then abandoned. Long-term identifiers are used for objects of a more wide-ranging and long-lasting nature.

PR_ENTRYID is always available through the IMAPIProp::GetPropsK06IXU method following the first call to the IMAPIProp::SaveChanges21IFXQ method. Some service providers can make it available immediately after instantiation. The provider must always return a long-term entry identifier from GetProps. Therefore, to convert a short-term identifier to long-term, simply open the object and get its PR_ENTRYID through GetProps.

The following table summarizes important differences among PR_ENTRYID, PR_RECORD_KEYQV4J.N, and PR_SEARCH_KEY_7GFC6.

Characteristic

PR_ENTRYID

PR_RECORD_KEY

PR_SEARCH_KEY

Required on attachment objects

No

Yes

No

Required on folder objects

Yes

Yes

No

Required on message store objects

Yes

Yes

No

Required on status objects

Yes

No

No

Created by client

No

No

Yes

Available before call to SaveChanges

Maybe

Maybe

Messages   Yes
Others
  Maybe

Changed in a copy operation

Yes

Yes

No

Changeable by client after a copy

No

No

Yes

Unique within

Entire world

Provider instance

Entire world

Binary comparable (as with memcmp)

No   use IMAPISupport::
CompareEntryIDs
_A5HY0

Yes

Yes

 

See Also

ENTRYID1.WJMCX, NOTIFICATION1KRZ0QA, PR_STORE_ENTRYIDSH8V.D