dispidApptTZDefStartDisplay
dispidApptTZDefStartDisplay |
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 start 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 |
Remarks
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 dispidApptTZDefStartDisplay to store the time zone for the start time. dispidApptTZDefStartDisplay is used to show the appointment or meeting in the original time zone that it was scheduled, and to determine whether the start time should be adjusted if the rules of the time zone change. If this property is missing, 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: | dispidApptTZDefStartDisplay |
Care must be taken when parsing a stream obtained from dispidApptTZDefStartDisplay, or when persisting TZDEFINITION to a stream for commitment to a binary property such as dispidApptTZDefStartDisplay. 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