PidLidAppointmentTimeZoneDefinitionRecur Canonical Property
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Contains a stream that maps to the persisted format of a TZDEFINITION structure, which stores the description for the time zone that is used when a recurring appointment or meeting request is created.
Associated properties: |
dispidApptTZDefRecur |
Property set: |
PSETID_Appointment |
Long ID (LID): |
0x00008260 |
Data type: |
PT_BINARY |
Area: |
Calendar |
Remarks
Microsoft Outlook 2007 and solutions based on Collaboration Data Objects (CDO) 1.2.1 that have run the Outlook or Exchange Server calendar update tool use the dispidApptTZDefRecur and dispidTimeZoneStruct (PidLidTimeZoneStruct) properties to determine whether the recurring meeting should be adjusted if the rules of the time zone change. These properties must be synchronized, because older clients may still manipulate the dispidTimeZoneStruct property. To detect whether the two properties are synchronized, 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 the dispidTimeZoneStruct property does not match the marked rule, the dispidApptTZDefRecur property should be discarded and dispidTimeZoneStruct should be used instead.
When you write both the dispidApptTZDefRecur and dispidTimeZoneStruct properties to a new recurring meeting, or, when you make an arbitrary choice to use the dispidTimeZoneStruct property, the current definition for the time zone (according to the Windows registry) should be used.
A parser must be careful when it reads a stream that is obtained from dispidApptTZDefRecur, or when it persists 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.
dispidApptTZDefRecur specifies time zone information that describes how to convert the meeting date and time on a recurring series to and from Coordinated Universal Time (UTC). If this property is set but it has data that is inconsistent with the data represented by dispidTimeZoneStruct, the client must use dispidTimeZoneStruct instead of dispidApptTZDefRecur. If dispidApptTZDefRecur is not set, the PidLidTimeZoneStruct property will be used instead. The fields in this BLOB are encoded in little-endian byte order.
Related Resources
Protocol Specifications
[MS-OXPROPS]
Provides property set definitions and references to related Exchange Server protocol specifications.[MS-OXOCAL]
Specifies the properties and operations for appointment, meeting request, and response messages.
Header Files
- Mapidefs.h
Provides data type definitions.