Contains a stream that maps to the persisted format of a TZDEFINITION structure, which stores the description for the time zone used when selecting the end time of a single-instance 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


Microsoft Office Outlook 2003, earlier versions of Outlook, and solutions that are based on Collaboration Data Objects (CDO) 1.21 and that have not run the calendar update tool by Outlook or Microsoft Exchange Server store the start time and end time of single-instance appointments and meeting requests in Universal Coordinated Time (UTC). These clients do not store any information for the time zone in which the appointment or meeting request is created.

Versions of Outlook since Outlook 2007, and solutions based on CDO 1.21 that have run the Outlook or Exchange calendar update tool use dispidApptTZDefEndDisplay to store the time zone for the end time. dispidApptTZDefEndDisplay is used to show the appointment or meeting in the original time it was scheduled, and to determine if the end time should be adjusted if the rules of the time zone change. If this property is missing, the time zone specified by dispidApptTZDefStartDisplay is used. If dispidApptTZDefStartDisplay is missing or invalid, then the current local time zone is assumed. This property is used for display purposes only and is not used in recurrence expansion.

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: dispidApptTZDefEndDisplay

Care must be taken when parsing a stream obtained from dispidApptTZDefEndDisplay, or when persisting TZDEFINITION to a stream for commitment to a binary property such as dispidApptTZDefEndDisplay. 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