williamr@2: // Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: // All rights reserved.
williamr@2: // This component and the accompanying materials are made available
williamr@2: // under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
williamr@2: // which accompanies this distribution, and is available
williamr@2: // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
williamr@2: //
williamr@2: // Initial Contributors:
williamr@2: // Nokia Corporation - initial contribution.
williamr@2: //
williamr@2: // Contributors:
williamr@2: //
williamr@2: // Description:
williamr@2: //
williamr@2: 
williamr@2: #ifndef __TZUPDATE_H__
williamr@2: #define __TZUPDATE_H__
williamr@2: 
williamr@2: #include <e32cmn.h> // TUid.
williamr@2: 
williamr@2: /** UTC Offset update notification constants. When the UTC offset is automatically
williamr@2: adjusted for Daylight Saving then it is possible to receive
williamr@2: notification using the Publish and Subscribe API with the
williamr@2: values defined here. Note that this property is updated by the Time Zone Server
williamr@2: as this is the only component that can modify the UTC Offset.
williamr@2: 
williamr@2: @see RProperty in e32property.h
williamr@2: @publishedAll
williamr@2: @released
williamr@2: @since 9.1
williamr@2: */
williamr@2: namespace NTzUpdate
williamr@2:     {
williamr@2:     const TUid KPropertyCategory = { 0x1020383E };
williamr@2: 
williamr@2:     enum TPropertyKeys
williamr@2:         {
williamr@2:         EUtcOffsetChangeNotification,
williamr@2:         ECurrentTimeZoneId,
williamr@2:         EHomeTimeZoneId,
williamr@2:         ENextDSTChange
williamr@2:         };
williamr@2: 
williamr@2: 	struct TTimeZoneChange
williamr@2: 		{
williamr@2: 		TInt iNewTimeZoneId;
williamr@2: 		TInt iOldTimeZoneId;
williamr@2: 		};
williamr@2: 		
williamr@2: 	/** This struct is used to publish DST Change info in an RProperty.
williamr@2: 	Subscribers to the property will define a copy of this struct
williamr@2: 	so that they are not dependant on the tz component.
williamr@2: 	If this struct changes then the copies must also be changed.
williamr@2: 	@internalTechnology
williamr@2: 	*/
williamr@2: 	struct TDSTChangeInfo
williamr@2: 		{
williamr@2: 		/** The version of the struct. Currently always 1 */
williamr@2: 		TUint8 iVersion;
williamr@2: 
williamr@2: 		/** The time of the next offset change in UTC */
williamr@2: 		TTime iNextDSTChangeUTC;
williamr@2: 		/** The offset from UTC (in minutes) after the next DST change will take place.*/
williamr@2: 		TInt iNextUTCOffset;
williamr@2: 		
williamr@2: 		/** The time of the previous offset change in UTC. This member is only valid if the version is 2 or above. */
williamr@2: 		TTime iPreviousDSTChangeUTC;
williamr@2: 
williamr@2: 		/** The offset from UTC (in minutes) before the previous DST change took place. This member is only valid
williamr@2: 		if the version is 2 or above.*/
williamr@2: 		TInt iPreviousUTCOffset;
williamr@2: 
williamr@2: 		/** Reserved for future use. */
williamr@2: 		TInt iReserved[12];
williamr@2: 		};
williamr@2:     }
williamr@2: 
williamr@2: #endif  // __TZUPDATE_H__