Contains a stream that maps to the persisted format of a TZDEFINITION structure, which stores the description for the time zone used when creating a recurring appointment or meeting request.

Quick Info

Exposed on: Message objects used for scheduling
Created by: Outlook
Accessed by: Outlook and solution providers
Property type: PT_BINARY
Access type: Read/write


Versions of Outlook since Outlook 2007, and solutions based on CDO 1.21 that have run the Outlook or Exchange calendar update tool use dispidApptTZDefRecur and dispidTimeZoneStruct to determine whether the recurring meeting should be adjusted if the rules of the time zone change. dispidApptTZDefRecur and dispidTimeZoneStruct must be kept in sync, because older clients may still manipulate dispidTimeZoneStruct. To detect if the two properties are in sync, the wFlags member for the rule that matches dispidTimeZoneStruct should have the TZRULE_FLAG_RECUR_CURRENT_TZREG flag set. If this flag is not set, or it is set and the rule in dispidTimeZoneStruct does not match the marked rule, then dispidApptTZDefRecur should be discarded and dispidTimeZoneStruct should be used instead.

When writing both dispidApptTZDefRecur and dispidTimeZoneStruct to a new recurring meeting, or when an arbitrary choice needs to be made to pick dispidTimeZoneStruct, the current definition for the time zone (according to the Windows registry) should be used.

To retrieve the value of this property, 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_Appointment
ulKind: MNID_ID
Kind.lID: dispidApptTZDefRecur

Care must be taken when parsing a stream obtained from dispidApptTZDefRecur, or when persisting TZDEFINITION to a stream for commitment to a binary property such as dispidApptTZDefRecur. For more information, see About Persisting TZDEFINITION to a Stream to Commit to a Binary Property.

See Also

About Rebasing Calendars Programmatically for Daylight Saving Time

Constants for Outlook Named Properties