--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/locsrv_pub/location_triggering_api/inc/lbttriggerdynamicinfo.h Tue Feb 02 01:06:48 2010 +0200
@@ -0,0 +1,115 @@
+/*
+* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description: Data class for trigger's dynamic system information.
+*
+*/
+
+
+#ifndef LBTTRIGGERDYNAMICINFO_H
+#define LBTTRIGGERDYNAMICINFO_H
+
+#include <lbtcommon.h>
+
+/**
+ * Data class for trigger's dynamic system information, such as
+ * trigger validity and distance to the latest acquired location.
+ *
+ * Client application can get following dynamic information of a trigger
+ * after it's created.
+ *
+ * - <B>Validity</B>. A trigger is set as invalid when the specified
+ * manager UI, owner process or trigger handling process( for start-up trigger )
+ * is removed from the system. The process can be removed for example when
+ * it resides in removable media( like MMC ), and that media is removed from
+ * the terminal. An invalid trigger is not included in the
+ * trigger supervision process. When the removable media with the specified
+ * process is attached back to the terminal, the trigger is set as
+ * valid and included in the trigger supervision process, provided
+ * that the trigger is not disabled. When a trigger has been invalid longer
+ * than the system clean-up time, the trigger is removed from the system.
+ * The system clean-up time is defined by the system and can't be accessed
+ * by client application. Note, if a trigger's owner process, manager UI
+ * or trigger handling process( for start-up trigger ) is uninstalled
+ * from the system, the trigger will be removed by Location Triggering
+ * Server.
+ *
+ * - <B>Distance to the Latest Acquired Location</B>.
+ *
+ * @lib lbt.lib
+ * @since S60 5.1
+ */
+struct TLbtTriggerDynamicInfo
+ {
+ /**
+ * Attributes of a trigger's dynamic information.
+ */
+ enum TLbtDynamicInfoAttribute
+ {
+ /**
+ * Validity status attribute.
+ */
+ EValidityStatus = 0x01,
+
+ /**
+ * Distance to latest acquired location fix.
+ */
+ EDistanceToLatestLocation = 0x02,
+
+ /**
+ * Last fired location information.
+ */
+ EFiredLocality = 0x04
+ };
+
+ /**
+ * Defines the trigger validity status.
+ */
+ enum TLbtTriggerValidity
+ {
+ /**
+ * Invalid
+ */
+ EInvalid = 1,
+ /**
+ * Valid
+ */
+ EValid = 2
+ };
+
+ /**
+ * Defines the trigger validity status.
+ */
+ TLbtTriggerValidity iValidity;
+
+ /**
+ * The distance in meters from the trigger to latest acquired
+ * location.
+ */
+ TReal iDistanceToLatestLocation;
+
+ /**
+ * Information of the location where the trigger was last fired. The
+ * information available will contain the latitude, longitude and
+ * horizontal accuracy values. Other details in TLocality will not
+ * be updated.
+ */
+ TLocality iFiredLocality;
+
+ /**
+ * For future use
+ */
+ TUint8 iUnused[8];
+ };
+
+#endif // LBTTRIGGERDYNAMICINFO_H