epoc32/include/mw/tzupdate.h
branchSymbian3
changeset 4 837f303aceeb
parent 3 e1b950c65cb4
--- a/epoc32/include/mw/tzupdate.h	Wed Mar 31 12:27:01 2010 +0100
+++ b/epoc32/include/mw/tzupdate.h	Wed Mar 31 12:33:34 2010 +0100
@@ -1,9 +1,9 @@
 // Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
 // All rights reserved.
 // This component and the accompanying materials are made available
-// 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
+// under the terms of "Eclipse Public License v1.0"
 // which accompanies this distribution, and is available
-// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
 //
 // Initial Contributors:
 // Nokia Corporation - initial contribution.
@@ -17,6 +17,7 @@
 #define __TZUPDATE_H__
 
 #include <e32cmn.h> // TUid.
+#include <e32std.h>
 
 /** UTC Offset update notification constants. When the UTC offset is automatically
 adjusted for Daylight Saving then it is possible to receive
@@ -25,22 +26,35 @@
 as this is the only component that can modify the UTC Offset.
 
 @see RProperty in e32property.h
-@publishedAll
-@released
-@since 9.1
 */
 namespace NTzUpdate
     {
+	/** Time zone services publish and subscribe property category.
+	@publishedAll
+	@released
+	*/
     const TUid KPropertyCategory = { 0x1020383E };
 
+	/** Time zone services publish and subscribe property keys.
+	@publishedAll
+	@released
+	*/
     enum TPropertyKeys
         {
         EUtcOffsetChangeNotification,
         ECurrentTimeZoneId,
         EHomeTimeZoneId,
-        ENextDSTChange
+        ENextDSTChange,
+		ETzRulesChange, 
+	    ETzNamesChange, 
         };
 
+	/** Structure used to return the value for ECurrentTimeZoneId or 
+	EHomeTimeZoneId property.
+	@see RTz::NotifyHomeTimeZoneChangedL
+	@publishedAll
+	@released
+	*/
 	struct TTimeZoneChange
 		{
 		TInt iNewTimeZoneId;
@@ -48,10 +62,11 @@
 		};
 		
 	/** This struct is used to publish DST Change info in an RProperty.
-	Subscribers to the property will define a copy of this struct
+	Subscribers to the ENextDSTChange property will define a copy of this struct
 	so that they are not dependant on the tz component.
 	If this struct changes then the copies must also be changed.
-	@internalTechnology
+	@publishedAll
+	@released
 	*/
 	struct TDSTChangeInfo
 		{
@@ -69,10 +84,32 @@
 		/** The offset from UTC (in minutes) before the previous DST change took place. This member is only valid
 		if the version is 2 or above.*/
 		TInt iPreviousUTCOffset;
-
-		/** Reserved for future use. */
+	private:
+		/** Reserved for future use. 
+		*/
 		TInt iReserved[12];
 		};
-    }
+	/** Structure used to return the value for ETzRulesChange property.
+	This property covers changes to the system TZ database, the current/system
+	TZ rules or user-defined TZ rules.
+	@publishedAll
+	@released
+	*/
+	struct TTzRulesChange
+    	{
+    	TTime iUTCTimeOfRulesChange;
+    	};
+    	
+	/** Structure used to return the value for ETzNamesChange property.
+	This property covers changes to either the localized system TZ names
+	or non-localized user-defined TZ names.
+	@publishedAll
+	@released
+	*/
+    struct TTzNamesChange
+    	{
+    	TTime iUTCTimeOfNamesChange;
+    	};
+     }
 
 #endif  // __TZUPDATE_H__