Criteria for change notifications

The criteria object specifies the system attribute to monitor for changes.

The criteria object has a three properties: Entity, Key, and SystemData. These are described in the following table. Properties enclosed in brackets are optional.

Table: Criteria object properties

Property

Description

Type

Value

criteria.Entity

Specifies the entity of the system attribute.

Together with Key, this specifies the system attribute to monitor.

For more information about entities, see section System attributes.

string

For a complete list of supported entities, see section Supported system attributes (entities and keys).

For example: "Battery"

criteria.Key

Specifies the key of the system attribute. The available keys depend on the entity.

Together with Entity, this specifies the system attribute to monitor.

For more information about keys, see section System attributes.

string

For a complete list of supported keys per entity, see the Key column of the tables in section Supported system attributes (entities and keys).

For example: "BatteryStrength"

[criteria.SystemData]

Specifies the value of the system attribute.

Some system attributes require this property as input for GetNotification. To find out which attributes, see the Input column of the tables in section Supported system attributes (entities and keys).

The SystemData object always has a single property, which represents the system attribute value. The type and content of the property depend on the system attribute (specifically, on the system data type used for input).

Typically, the property contains status information represented by a number or string. The property can also be an object for representing more complex values, such as drive information.

For more information about system attribute values, see sections Supported system attributes (entities and keys).

object

The object property depends on the system attribute. See the Input column cell for the appropriate system attribute in section Supported system attributes (entities and keys).

For example, the Battery - BatteryStrength system attribute takes Status (number) as input for GetNotification:

SystemData.Status = 50
© Nokia 2008.