PR_RESOURCE_FLAGS

The PR_RESOURCE_FLAGS property contains a bitmask of flags for message services and providers.

Quick Info

Header file: MAPITAGS.H
Must be exposed by: Status objects
Must be a column in: Message service, message store, and status tables
Identifier: 0x3009
Property type: PT_LONG
Property tag: 0x30090003

Remarks

PR_RESOURCE_FLAGS describes the characteristics of a message service, a service provider, or a status object. The flags that are set for PR_RESOURCE_FLAGS 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 PR_RESOURCE_FLAGS:

SERVICE_CREATE_WITH_STORE
Reserved. Do not use.
SERVICE_DEFAULT_STORE
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.
SERVICE_NO_PRIMARY_IDENTITY
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.
SERVICE_PRIMARY_IDENTITY
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.
SERVICE_SINGLE_COPY
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:

HOOK_INBOUND
Static. The spooler hook needs to process inbound messages.
HOOK_OUTBOUND
Static. The spooler hook needs to process outbound messages.
STATUS_DEFAULT_OUTBOUND
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.
STATUS_DEFAULT_STORE
Modifiable. This message store is the default store for the profile.
STATUS_NEED_IPM_TREE
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.
STATUS_NO_DEFAULT_STORE
Static. This message store is incapable of becoming the default message store for the profile.
STATUS_NO_PRIMARY_IDENTITY
Static. This provider does not furnish an identity in its status row. Either this flag or STATUS_PRIMARY_IDENTITY must be set.
STATUS_OWN_STORE
Static. This transport provider is tightly coupled with a message store and furnishes the PR_OWN_STORE_ENTRYID property in its status row.
STATUS_PRIMARY_IDENTITY
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.
STATUS_PRIMARY_STORE
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.
STATUS_SECONDARY_STORE
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.
STATUS_SIMPLE_STORE
Dynamic. This message store will be used by Simple MAPI or CMC as its default message store.
STATUS_TEMP_SECTION
Dynamic. This message store should not be published in the message store table and will be deleted from the profile after logoff.
STATUS_XP_PREFER_LAST
Static. This transport expects to be the last transport selected to send a message when multiple transport providers are able to transmit the message.

See Also

Provider Properties, IMsgServiceAdmin::MsgServiceTransportOrder, PR_IDENTITY_ENTRYID