IABContainer : IMAPIContainer

Applies to: Office 2010 | Outlook 2010 | Visual Studio

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

CreateEntry

Creates a new entry, which can be a messaging user, a distribution list, or another container.

CopyEntries

Copies one or more entries, typically messaging users or distribution lists.

DeleteEntries

Removes one or more entries, typically messaging users, distribution lists, or other containers.

ResolveNames

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 : IMAPIProp and IMAPIProp : IUnknown 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 called the personal address book (PAB) that holds 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.

See Also

Concepts

MAPI Interfaces