PidTagResourceFlags Canonical Property

Last modified: January 16, 2009

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Contains a bitmask of flags for message services and providers.

Associated properties:




Data type:



MAPI common

This property describes the characteristics of a message service, a service provider, or a status object. The flags that are set for this property depend on its context. For example, some flags are valid only for status objects and other flags only for columns in the message service table.

The flags are of three classes: static, modifiable, and dynamic. Static flags are set by MAPI from data in MAPISVC.INF and never altered. Modifiable flags are set by MAPI from MAPISVC.INF but can be subsequently changed. Dynamic flags can be set and reset by MAPI methods.

For a message service, one or more of the following flags can be set in this property:


Reserved. Do not use.


Dynamic. The message service contains the default store. A user interface should be displayed prompting the user for confirmation before deleting or moving this service out of the profile.


Static. The service level flag that should be set to indicate that none of the providers in the message service can be used to supply an identity. Either this flag or SERVICE_PRIMARY_IDENTITY should be set, but not both.


Modifiable. The corresponding message service contains the provider used for the primary identity for this session. Use IMsgServiceAdmin::SetPrimaryIdentity to set this flag. Either this flag or SERVICE_NO_PRIMARY_IDENTITY should be set, but not both.


Static. Any attempt to create or copy this message service into a profile where the service already exists will fail. To create a single copy message service add the PR_RESOURCE_FLAGS property to the service's section in MAPISVC.INF and set this flag.

For a service provider, one or more of the following flags can be set in PR_RESOURCE_FLAGS:


Static. The spooler hook needs to process inbound messages.


Static. The spooler hook needs to process outbound messages.


Modifiable. This identity should be applied to outbound messages if the profile contains multiple instances of this transport provider. This can happen if multiple instances of a single transport provider appear in the profile.


Modifiable. This message store is the default store for the profile.


Dynamic. The standard folders in this message store, including the interpersonal message (IPM) root folder, have not yet been verified. MAPI sets and clears this flag.


Static. This message store is incapable of becoming the default message store for the profile.


Static. This provider does not furnish an identity in its status row. Either this flag or STATUS_PRIMARY_IDENTITY must be set.


Static. This transport provider is tightly coupled with a message store and furnishes the PR_OWN_STORE_ENTRYID (PidTagOwnStoreEntryId) property in its status row.


Modifiable. This provider furnishes the primary identity for the session; the entry identifier for the object furnishing the identity is returned from IMAPISession::QueryIdentity. Either this flag or STATUS_NO_PRIMARY_IDENTITY must be set.


Modifiable. This message store is to be used when a client application logs on. Once opened, this store should be set as the default store for the profile.


Modifiable. This message store is to be used if the primary store is not available when a client application logs on. Once opened, this store should be set as the default store for the profile.


Dynamic. This message store will be used by Simple MAPI as its default message store.


Dynamic. This message store should not be published in the message store table and will be deleted from the profile after logoff.


Static. This transport expects to be the last transport selected to send a message when multiple transport providers are able to transmit the message.

Header Files


Provides data type definitions.


Contains definitions of properties listed as alternate names.