userlibandfileserver/domainmgr/inc/domaindefs.h
changeset 279 957c583b417b
parent 0 a41df078684a
--- a/userlibandfileserver/domainmgr/inc/domaindefs.h	Tue Sep 28 15:28:31 2010 +0100
+++ b/userlibandfileserver/domainmgr/inc/domaindefs.h	Mon Oct 04 12:03:52 2010 +0100
@@ -1,4 +1,4 @@
-// Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).
+// Copyright (c) 2002-2010 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 "Eclipse Public License v1.0"
@@ -11,6 +11,7 @@
 // Contributors:
 //
 // Description:
+// Contains the common definitions for the Domain Manager interface for clients.
 //
 // WARNING: This file contains some APIs which are internal and are subject
 //          to change without notice. Such APIs should therefore not be used
@@ -23,6 +24,7 @@
 #include <e32cmn.h>
 #include <e32power.h>
 
+
 /**
 @internalTechnology
 */
@@ -159,7 +161,8 @@
 /**
 @internalTechnology
 
-The power domain hierarchy Id.
+The power domain hierarchy Id. This hierarchy is used in development 
+platforms.
 */
 static const TDmHierarchyId	KDmHierarchyIdPower		= 1;
 
@@ -169,7 +172,8 @@
 /**
 @internalAll
 
-The start-up domain hierarchy Id.
+The system state start-up and shutdown domain hierarchy Id. This hierarchy is
+used in production devices.
 */
 static const TDmHierarchyId	KDmHierarchyIdStartup	= 2;
 
@@ -248,6 +252,35 @@
 
 
 
+/**
+The possible ways in which the domain manager can behave when a transition 
+fails. 
+
+@see TDmHierarchyPolicy
+@see TDmStateSpecV1
+@see DmPolicyGetPolicy
+*/
+enum TDmTransitionFailurePolicy
+	{
+	// Failure policies
+	
+	/**	The domain manager stops at the first transition failure */
+	ETransitionFailureStop,
+
+	/** The domain manager continues at any transition failure */
+	ETransitionFailureContinue,
+
+
+	// Special failure policies
+
+	/** Used in SDmStateSpecV1 when the default failure policy for the 
+	hierarchy should be used. The default failure policy is
+	returned by the DmPolicyGetPolicy() function, ordinal 3 in
+	the policy library. */
+	ETransitionFailureUsePolicyFromOrdinal3 = 256
+	};
+
+
 
 /**
 @publishedPartner
@@ -385,5 +418,8 @@
 */
 static const TInt KErrBadHierarchyId	= -263;
 
+
+
+
 #endif