The CDO Libraries and MAPI

The CDO libraries call Microsoft COM and MAPI interfaces for you. The following table describes the MAPI interfaces that the CDO Library calls when you manipulate a CDO Library object.

CDO
Library object
COM or MAPI interface called by the
CDO Library
AddressEntry IMailUser
AddressEntryFilter IMAPITable (with Restrict method)
AddressList IABContainer
Attachment IAttach
Field IMAPIProp, IStream
Folder IMAPIFolder
InfoStore IMsgStore
Message IMessage
MessageFilter IMAPITable (with Restrict method)
Recipient IMAPITable row (recipient table from IMessage)
Session IMAPISession

For collection objects, the CDO libraries call the MAPI interface IMAPITable.

The CDO libraries also call the MAPI interface IMAPIProp. Many of the properties exposed by the CDO libraries are based on MAPI properties. The following table describes the mapping between these CDO library properties and the underlying MAPI properties.

CDO
library object

Property

MAPI property

MAPI property type
AddressEntry Address PR_EMAIL_ADDRESS PT_TSTRING
AddressEntry DisplayType PR_DISPLAY_TYPE PT_LONG
AddressEntry ID PR_ENTRYID PT_BINARY
AddressEntry Name PR_DISPLAY_NAME PT_TSTRING
AddressEntry Type PR_ADDRTYPE PT_TSTRING
AddressList ID PR_ENTRYID PT_BINARY
AddressList Name PR_DISPLAY_NAME PT_TSTRING
Attachment Index PR_ATTACH_NUM PT_LONG
Attachment Name PR_ATTACH_
FILENAME
PT_TSTRING
Attachment Position PR_RENDERING_
POSITION
PT_LONG
Attachment Source PR_ATTACH_
PATHNAME
PT_TSTRING
Attachment Type PR_ATTACH_
METHOD
PT_LONG
Folder FolderID PR_PARENT_
ENTRYID
PT_BINARY
Folder ID PR_ENTRYID PT_BINARY
Folder Name PR_DISPLAY_NAME PT_TSTRING
Folder StoreID PR_STORE_ENTRYID PT_BINARY
InfoStore ID PR_ENTRYID PT_BINARY
InfoStore Name PR_DISPLAY_NAME PT_TSTRING
InfoStore ProviderName PR_PROVIDER_DISPLAY PT_TSTRING
Message Conversation PR_CONVERSATION_
KEY
PT_BINARY
Message Conversation
Index
PR_CONVERSATION_
INDEX
PT_BINARY
Message Conversation
Topic
PR_CONVERSATION_
TOPIC
PT_STRING
Message Delivery
Receipt
PR_ORIGINATOR_
DELIVERY_REPORT_
REQUESTED
PT_BOOLEAN
Message Encrypted PR_SECURITY PT_LONG
Message FolderID PR_PARENT_ENTRYID PT_BINARY
Message ID PR_ENTRYID PT_BINARY
Message Importance PR_IMPORTANCE PT_LONG
Message ReadReceipt PR_READ_RECEIPT_
REQUESTED
PT_BOOLEAN
Message Sender PR_SENDER_
ENTRYID
PT_BINARY
Message Sent PR_MESSAGE_FLAGS PT_LONG
Message Signed PR_SECURITY PT_LONG
Message Size PR_MESSAGE_SIZE PT_LONG
Message StoreID PR_STORE_ENTRYID PT_BINARY
Message Subject PR_SUBJECT PT_TSTRING
Message Submitted PR_MESSAGE_FLAGS PT_LONG
Message Text PR_BODY PT_TSTRING
Message Time
Received
PR_MESSAGE_
DELIVERY_TIME
PT_SYSTIME
Message TimeSent PR_CLIENT_SUBMIT_
TIME
PT_SYSTIME
Message Type PR_MESSAGE_CLASS PT_TSTRING
Message Unread PR_MESSAGE_FLAGS PT_LONG
Recipient Address combination of PR_ADDRTYPE and PR_EMAIL_ADDRESS PT_TSTRING
Recipient DisplayType PR_DISPLAY_TYPE PT_LONG
Recipient Name PR_DISPLAY_NAME PT_TSTRING
Recipient Type PR_RECIPIENT_TYPE PT_LONG
Session Name PR_DISPLAY_NAME PT_TSTRING

For more information about MAPI properties, see the MAPI Programmer's Reference.