Poll Request to the Server (Windows Embedded CE 6.0)
1/6/2010
The end user or administrator configures the target device with default settings to poll a specific server at a specific time and interval. This is done either through the API or through the user interface (UI). The poll server through its response to the target device poll may change these settings.
The polling interval is specified in the registry. This polling interval specifies how often to contact the server. If a connection attempt fails for a period, the client will retry after the retry timeout. This will be repeated depending on the number of entries specified in the registry. The default values are one hour for the polling interval and 3 minutes for retries with the maximum number of retries being five. The poll task never expires and is thus, always rescheduled.
The polling is achieved as a standard HTTP POST. The polling format describes the format of the Poll data that is sent to the server, which is the device proxy in the case of Microsoft Systems Management Server.
The polling information sent to the server has two parts:
- HTTP headers
- POST data in XML
Poll Request XML Elements
The following table shows the Poll request XML elements.
| Element | Description |
|---|---|
Root element of the Poll document. |
|
Top-level element of the section that provides information about the management system being used to manage this target device. |
|
Name of the management system being used to manage this target device. |
|
Version of the management system being used to manage this target device. |
|
Top-level element of the section that provides information used to identify the target device. |
|
Unique ID of the target device. |
|
Name of the target device. |
|
Username of the target device user. |
|
Domain of the target device user. |
|
Hardware platform of the target device. |
|
Type of processor running the target device. |
|
Codepage used when generating the XML document. |
|
System-default locale identifier currently used by the target device. |
|
Top-level element of the section that provides information about the target device's connection to the network. |
|
IP address of the target device. |
|
IP subnet of the target device. |
|
MAC address of the target device's network adapter. |
|
Top-level element of the section that provides additional information about the connection context. This information is specifically relevant to the nature of the connection between managed target device and management server. |
|
An authorization token optionally used as part of client authentication. |
|
A timestamp value maintained by the management server. |
Poll Request Schema
The following schema is recommended for a Poll request to the server.
<DevicePoll xmlns="Default XML namespace for the XML document">
<ManagementSystem>
<Name>"Name of the management system"</Name>
<Version>"Version of the management system"</Version>
</ManagementSystem>
<Identification>
<ID>"Unique ID of the device"</ID>
<DeviceName>"Device's name"</DeviceName>
<UserName>"Device user's username"</UserName>
<Domain>"Device user's domain"</Domain>
<Platform>"Hardware platform of the device"</Platform>
<Processor>"Processor running on the device"</Processor>
<CodePage>"Codepage used when generating XML document"</CodePage>
<SystemDefaultLCID>"System-default locale ID"</SystemDefaultLCID>
<NetworkAdapter>
<IPAddress>"Device IP address"</IPAddress>
<IPSubnet>"Device IP subnet"</IPSubnet>
<MAC>"Device network adapter MAC address"</MAC>
</NetworkAdapter>
</Identification>
<Connection>
<AuthorizationToken>"Authorization token"</AuthorizationToken>
<Timestamp>"Management server's timestamp</Timestamp>
</Connection>
</DevicePoll>
Poll Request Example
The following code example shows a Poll request to the server.
X-Device-UUID:43004500500043000000434550434B5335343934350000000000
X-Device-Auth:d302b047-c9a2-4a11-a392-df84195d2808
X-Device-Timestamp:4/7/2002 10:09:27 PM
X-Device-Action:Poll
<DevicePoll xmlns="https://www.microsoft.com/DeviceManagement.xsd">
<ManagementSystem>
<Name> Systems Management Server Device Management</Name>
<Version>2.5.0.0</Version>
</ManagementSystem>
<Identification>
<ID>43004500500043000000434550434B5335343934350000000000</ID>
<DeviceName>WindowsCE</DeviceName>
<UserName>KenKwok</UserName>
<Platform>CEPC platform</Platform>
<Processor>586</Processor>
<CodePage>437</CodePage>
<SystemDefaultLCID>1033</SystemDefaultLCID>
<NetworkAdapter>
<IPAddress>172.18.42.254</IPAddress>
<IPSubnet>255.255.252.0</IPSubnet>
<MAC>172.18.42.254</MAC>
</NetworkAdapter>
</Identification>
<Connection>
<AuthorizationToken>316e47ab-5ca7-4531-a0a7 8b095eafb7df</AuthorizationToken>
<Timestamp>4/7/2002 10:09:27 PM</Timestamp>
</Connection>
</DevicePoll>