System Properties
Applications can request a named system property, which is currently limited to the device ID. The device ID, or nduid, is a 20-byte (160 bit) SHA-1 digest unique to each device.
Your application should not use the device ID to uniquely identify a given user. Because devices may be bought, sold, exchanged, or even serviced in a way that results in a user's device ID changing or being transferred to another user, user data and preferences should never be saved and restored on the basis of the device ID; you should implement your own account management system for this purpose.
Method
This section describes the following method:
- Get
Get
Requests the named system property, which is returned in a response object.
Required parameter:
- key
Parameters
Parameter | Type | Description |
---|---|---|
key | string | Set to "com.palm.properties.nduid", which is the device's unique ID. |
Return Handling
onSuccess
Attribute | Type | Description |
---|---|---|
key | string | Set to the input key. |
value | string | Set to value of the input key. |
Example
this.controller.serviceRequest('palm://com.palm.preferences/systemProperties', { method:"Get", parameters:{"key": "com.palm.properties.nduid" }, onSuccess: function(response){} });
Sample Code
See Services Sample.