TZDEFINITION

Represents an entire time zone including all historical, current, and future time zone shift rules for daylight saving time.

Quick Info

  typedef struct {
    WORD     wFlags; 
    GUID     guidTZID;
    LPWSTR   pwszKeyName;
    WORD     cRules;
    TZRULE*  rgRules;
} TZDEFINITION;

Members

wFlags

Indicates which of the two fields, the GUID and the key name, are valid. The possible flags for this member are:

TZDEFINITION_FLAG_VALID_GUID - The GUID is valid.

TZDEFINITION_FLAG_VALID_KEYNAME - The name of the key is valid.

guidTZID

A GUID that uniquely identifies the time zone.

pwszKeyName

The name of the key for this time zone in the Windows registry. This name must not be localized. It has a maximum size of MAX_PATH, which is defined in the Microsoft Windows Software Development Kit (SDK) header file, windows.h.

cRules

The number of time zone rules for this definition. The maximum number of rules is TZ_MAX_RULES.

rgRules

An array of rules describing when shifts occur.

Remarks

Each TZDEFINITION is always identified by a key name. The key name and the GUID are used to determine whether one time zone is the same as another. If two time zone structures have GUIDs, using the GUID is the preferred way to determine if the two structures identify the same time time zone.

There must be at least one rule in rgRules. The first rule in rgRules is considered to be the rule to use until the second rule starts regardless of the stStart on the first rule. The rules should be sorted from oldest to newest. There is no overlap allowed between rules, and so a prior rule is deemed to end when a new rule starts.

See Also

About Rebasing Calendars Programmatically for Daylight Saving Time

Constants for Exported Outlook APIs

HrCreateApptRebaser