Supporting Named Properties

Any object that implements the IMAPIProp interface can support named properties. Support for named properties is required for:

• Address book providers that allow entries from other providers to be copied into their containers.
• Message store providers that can be used to create arbitrary message types.

Named property support is optional for all other service providers. Service providers that do support named properties implement name-to-identifier mapping in two IMAPIProp methods, GetNamesFromIDs and GetIDsFromNames. Clients call GetNamesFromIDs to retrieve the corresponding names for one or more property identifiers in the over 0x8000 range and GetIDsFromNames to either create or retrieve the identifiers for one or more names.

Service providers that do not support named properties must:

• Fail calls to IMAPIProp::SetProps to set properties with identifiers of 0x8000 or greater by returning MAPI_E_UNEXPECTED_ID in the SPropProblem array.
• Return MAPI_E_NO_SUPPORT from the GetNamesFromIDs and GetIDsFromNames methods.