IABContainer : IMAPIContainer
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Provides access to address book containers. MAPI and client applications call the methods of IABContainer to perform name resolution and to create, copy, and delete recipients.
Header file: |
Mapidefs.h |
Exposed by: |
Address book container objects |
Implemented by: |
Address book providers |
Called by: |
MAPI and client applications |
Interface identifier: |
IID_IABContainer |
Pointer type: |
LPABCONT |
Transaction model: |
Transacted |
Vtable Order
Creates a new entry, which can be a messaging user, a distribution list, or another container. |
|
Copies one or more entries, typically messaging users or distribution lists. |
|
Removes one or more entries, typically messaging users, distribution lists, or other containers. |
|
Performs name resolution for one or more recipient entries. |
Required properties |
Access |
|---|---|
PR_CONTAINER_FLAGS (PidTagContainerFlags) |
Read/write |
PR_DISPLAY_NAME (PidTagDisplayName) |
Read/write |
PR_ENTRYID (PidTagEntryId) |
Read-only |
PR_OBJECT_TYPE (PidTagObjectType) |
Read-only |
PR_RECORD_KEY (PidTagRecordKey) |
Read-only |
Optional properties |
Access |
|---|---|
PR_CONTAINER_CONTENTS (PidTagContainerContents) |
Read-only |
PR_CONTAINER_HIERARCHY (PidTagContainerHierarchy) |
Read-only |
PR_DEF_CREATE_DL (PidTagDefCreateDl) |
Read-only |
PR_DEF_CREATE_MAILUSER (PidTagDefCreateMailuser) |
Read-only |
PR_DISPLAY_TYPE (PidTagDisplayType) |
Read-only |
Remarks
The IABContainer interface inherits indirectly from the IUnknown interface through the IMAPIContainer and IMAPIProp interfaces. Address book providers implement the IABContainer interface.
Any number of messaging user objects, distribution lists, and other address book containers can exist in an address book container. As with any container, clients or service providers can use an address book container to open one of its entries or to retrieve a hierarchy table or contents table. Address book containers also provide name resolution and, depending on the provider, the ability to add, remove, or modify entries.
MAPI defines a special address book container, which is named the personal address book (PAB), that is meant to hold entries copied from other containers. A PAB is always modifiable. Users typically populate their PAB with entries designating the recipients with which they most frequently communicate. A PAB can also hold one-off addresses and new recipients not yet a part of any address book container.