Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Other versions of this page are also available for the following:
Windows Mobile Not Supported Windows Embedded CE Supported
8/28/2008

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

DevicePoll

Root element of the Poll document.

ManagementSystem

Top-level element of the section that provides information about the management system being used to manage this target device.

Name

Name of the management system being used to manage this target device .

Version

Version of the management system being used to manage this target device.

Identification

Top-level element of the section that provides information used to identify the target device.

ID

Unique ID of the target device.

DeviceName

Name of the target device.

UserName

Username of the target device user.

Domain

Domain of the target device user.

Platform

Hardware platform of the target device.

Processor

Type of processor running the target device.

codePage

Codepage used when generating the XML document.

SystemDefaultLCID

System-default locale identifier currently used by the target device.

NetworkAdapter

Top-level element of the section that provides information about the target device's connection to the network.

IPAddress

IP address of the target device.

IPSubnet

IP subnet of the target device.

MAC

MAC address of the target device's network adapter.

Connection

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.

AuthorizationToken

An authorization token optionally used as part of client authentication.

Timestamp

A timestamp value maintained by the management server.

Poll Request Schema

The following schema is recommended for a Poll request to the server.

Copy Code
<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.

Copy Code
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="http://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>

See Also