NoFolderScan

Applies to: Outlook 2013 | Outlook 2016

Specifies whether Microsoft Office Outlook should scan Contacts folders on a store.

Quick info

Property Value
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:

Property Value
lpGuid:
PSETID_Common
ulKind:
MNID_STRING
Kind.lpwstrName:
L"NoFolderScan"

This property provides a way for store providers to specify to Outlook not to scan Contacts folders in the store to avoid performance degradation. It is used in mail merge operations during which Outlook checks for the presence and value of this property before initiating the scan.

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

  • Zero (0): Outlook can carry out the scan.

  • Non-zero value: Outlook should not scan Contacts folders on the store.