5.9 KiB
title, description, ms.reviewer, manager, ms.author, ms.topic, ms.prod, ms.technology, author, ms.date
| title | description | ms.reviewer | manager | ms.author | ms.topic | ms.prod | ms.technology | author | ms.date |
|---|---|---|---|---|---|---|---|---|---|
| RemoteFind CSP | The RemoteFind configuration service provider retrieves the location information for a particular device. | aaroncz | vinpa | article | w10 | windows | vinaypamnani-msft | 06/26/2017 |
RemoteFind CSP
The table below shows the applicability of Windows:
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
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>