PidLidAppointmentTimeZoneDefinitionRecur Canonical Property

Applies to: Office 2010 | Outlook 2010 | Visual Studio

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

Versions of Microsoft Outlook since Microsoft Office 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.

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.

See Also

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names