PidTagContainerFlags Canonical Property

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Contains a bitmask of flags describing capabilities of an address book container.

Associated properties:

PR_CONTAINER_FLAGS

Identifier:

0x3600

Data type:

PT_LONG

Area:

Address book

Remarks

One or more of the following flags can be set for the bitmask:

  • AB_FIND_ON_OPEN
    Displays a dialog box to request a restriction before displaying any contents of the container.

  • AB_MODIFIABLE
    Entries can be added to and removed from the container. This flag does not indicate whether any entries in the container can be modified.

  • AB_RECIPIENTS
    The container can hold recipients. This flag does not indicate whether any recipients are actually present in the container, or whether they can be added or removed.

  • AB_SUBCONTAINERS
    The container can hold child containers. This flag does not indicate whether any subcontainers are actually present in the container, nor whether they can be added or removed. AB_SUBCONTAINERS must be set for the container to support IMAPIContainer::GetHierarchyTable.

  • AB_UNMODIFIABLE
    Entries cannot be added to or removed from the container. This flag does not indicate whether any entries in the container can be modified.

The AB_FIND_ON_OPEN flag is highly recommended for containers used with online services or with slow connections to servers. When a container is opened that has AB_FIND_ON_OPEN set, a Find dialog box is presented to the user to restrict the displayed messaging users. Even a partial specification limiting the messaging users can dramatically speed up a display of the contents.

Either the AB_MODIFIABLE or AB_UNMODIFIABLE flag must be set. Both flags can be set to indicate that the container does not know whether it can be modified or not, for example if modification depends on the user's access rights. In this case, a client application must attempt a call and examine the return code to determine the container's capabilities. A client typically starts by examining AB_MODIFIABLE. If it is set, the client makes a call that attempts to modify the container and checks the return value.

The AB_MODIFIABLE flag does not indicate what types of entries can be added to the container. To determine this, the client should use the appropriate OpenProperty method to open the container's PR_CREATE_TEMPLATES (PidTagCreateTemplates) property. Opening PR_CREATE_TEMPLATES causes the container's one-off table to be returned, listing the kinds of entries that can be created in the container.

Protocol Specifications

  • [MS-OXPROPS]
    Provides references to related Exchange Server protocol specifications.

  • [MS-OXOABK]
    Specifies the properties and operations for lists of users, contacts, groups, and resources.

  • [MS-NSPI]
    Handles a client's communications with a Name Service Provider Interface (NSPI) server.

Header Files

  • Mapidefs.h
    Provides data type definitions.

  • Mapitags.h
    Contains definitions of properties listed as associated properties.

See Also

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names