RemoteFind CSP

The table below shows the applicability of Windows:

The RemoteFind configuration service provider retrieves the location information for a particular device.

The following example shows the RemoteFind configuration service provider management object in tree format as used by OMA Client Provisioning.

./Vendor/MSFT
RemoteFind
----DesiredAccuracy
----MaximumAge
----Timeout
----Location
--------Latitude
--------Longitude
--------Altitude
--------Accuracy
--------AltitudeAccuracy
--------Age

DesiredAccuracy Optional. The node accepts the requested radius value in meters. Valid values for accuracy are any value between 1 and 1000 meters.

The default value is 50. Replacing this value only replaces it for the current session. The value isn't retained.

• Supported operations are Replace and Get.
• The Add command isn't supported.

Timeout Optional. Value is DWORD in seconds.

The default value is 7, and the range is 0 to 1800 seconds. Replacing this value only replaces it for the current session. The value isn't retained.

• Supported operations are Replace and Get.
• The Add command isn't supported.

MaximumAge Optional. The value represents the desired time window in minutes that the server will accept a successful location retrieval. The node enables the server to set the requested age value in 100 nanoseconds. Valid values for accuracy include any integer value between 0 and 1440 minutes.

The default value is 60. Replacing this value only replaces it for the current session. The value isn't retained.

• Supported operations are Replace and Get.
• The Add command isn't supported.

Location Required. Nodes under this path must be queried atomically in order to succeed. This condition is to prevent servers from querying incomplete sets of data.

Latitude Required. Provides the latitude of the last successful remote find.

The value returned is double.

The default value is Null.

Supported operation is Get.

Longitude Required. Provides the longitude of the last successful remote find.

The value returned is double.

The default value is Null.

Supported operation is Get.

Altitude Required. Provides the altitude of the last successful remote find.

The value returned is double.

The default value is Null.

Supported operation is Get.

Accuracy Required. Provides the accuracy in meters of the location fix of the last successful remote find. Values range from 0 – 1000 meters.

The value returned is an integer.

The default value is 0.

Supported operation is Get.

AltitudeAccuracy Required. Provides the altitude accuracy in meters of the location fix of the last successful remote find. Values range from 0 – 1000 meters.

The value returned is an integer.

The default value is 0.

Supported operation is Get.

Age Required. Provides the age in 100 nanoseconds for the current location data.

The value returned is an integer.

The default value is 0.

Supported operation is Get.

Examples

<SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
        <Atomic>
            <CmdID>1</CmdID>
            <Sequence>
                <CmdID>10</CmdID>
                <Get>
                    <CmdID>30</CmdID>
                    <Item>
                        <Target>
                            <LocURI>./Vendor/MSFT/RemoteFind/Location/Latitude</LocURI>
                        </Target>
                    </Item>
                </Get>
                <Get>
                    <CmdID>40</CmdID>
                    <Item>
                        <Target>
                            <LocURI>./Vendor/MSFT/RemoteFind/Location/Longitude</LocURI>
                        </Target>
                    </Item>
                </Get>
                <Get>
                    <CmdID>40</CmdID>
                    <Item>
                        <Target>
                            <LocURI>./Vendor/MSFT/RemoteFind/Location/Altitude</LocURI>
                        </Target>
                    </Item>
                </Get>
                <Get>
                    <CmdID>45</CmdID>
                    <Item>
                        <Target>
                            <LocURI>./Vendor/MSFT/RemoteFind/Location/Accuracy</LocURI>
                        </Target>
                    </Item>
                </Get>
                <Get>
                    <CmdID>50</CmdID>
                    <Item>
                        <Target>
                            <LocURI>./Vendor/MSFT/RemoteFind/Location/AltitudeAccuracy</LocURI>
                        </Target>
                    </Item>
                </Get>
                <Get>
                    <CmdID>60</CmdID>
                    <Item>
                        <Target>
                            <LocURI>./Vendor/MSFT/RemoteFind/Location/Age</LocURI>
                        </Target>
                    </Item>
                </Get>
            </Sequence>
        </Atomic>
    </SyncBody>
</SyncML>

Related topics

Configuration service provider reference