ArchiveSourceSupportMask

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Specifies whether Microsoft Office Outlook should scan folders in a store and archive them automatically.

Quick Info

Exposed on:

IMsgStore : IMAPIProp object

Created by:

Store provider

Accessed by:

Outlook and other clients

Property type:

PT_LONG

Access type:

Read-only or read/write depending on the store provider

Remarks

To provide any of the store functionality, the store provider must implement IMAPIProp : IUnknown and return a valid property tag for any of these properties passed to an IMAPIProp::GetIDsFromNames call. When the property tag for any of these properties is passed to IMAPIProp::GetProps, the store provider must also return the correct property value. Store providers can call HrGetOneProp and HrSetOneProp to get or set these properties.

To retrieve the value of this property, the client should first use IMAPIProp::GetIDsFromNames to obtain the property tag, and then specify this property tag in IMAPIProp::GetProps to get the value. When calling IMAPIProp::GetIDsFromNames, specify the following values for the MAPINAMEID structure pointed at by the input parameter lppPropNames:

lpGuid:

PSETID_Common

ulKind:

MNID_STRING

Kind.lpwstrName:

L"ArchiveSourceSupportMask"

This property allows store providers to specify whether Outlook should scan folders in a store and archive them automatically.

By default, this property is not exposed on a store, which means Outlook can scan folders on the store. If the property is exposed, the following are the possible values:

enum { 
 ASM_DEFAULT              = 0, 
 ASM_DO_NOT_ARCHIVE         = 1 << 0x0, 
 ASM_CLIENT_DO_NOT_CHANGE = 1 << 0xF 
};

ASM_DEFAULT

  • Outlook can scan folders on the store.

ASM_DO_NOT_ARCHIVE

  • Outlook should not scan folders on the store.

ASM_CLIENT_DO_NOT_CHANGE

  • Do not allow clients to change this property on the store. Note that the constant ASM_CLIENT_DO_NOT_CHANGE is for future reference and is not currently implemented. For now, a store can prevent clients from changing this flag by hardcoding the value that the store returns for this property.