dispidApptTZDefRecur

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

Remarks

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:

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