Share via


Instruction Response from the Server (Windows Embedded CE 6.0)

1/6/2010

The download instructions are an XML document and contain information about one or more downloads and each download can include the download of one or more files. Download instructions can optionally include the command line of a program to run after the download is completed.

Instruction Response XML Elements

The following table shows the Instruction Response XML elements.

Element Description

Instructions

Root element of the Instructions Response document.

Required

Specifies whether the download and execution of the package is mandatory or optional.

Name

Name of the package.

ShortDescription

A short description of the package.

LongDescription

A longer description of the package.

PackageSize

Size of the package, in bytes.

Flags

A set of flags (32 bit bitmask) used to encode network connection-related constraints.

StartTime

Time at which this package is to be downloaded and executed.

Recurrence

Top-level element of the section that defines the behavior of recurring packages.

Interval

How often the, optional, download and execution of the package is to occur.

Behavior

Defines the download behavior of recurring packages. Following the initial download and execution, subsequent packages will either be downloaded and executed or just executed. If they are just executed, no additional downloads follow the initial download.

LocalDestination

Location on the client where the package contents are to be saved.

CommandLine

Command line to be executed for this package.

SourceFiles

Specifies whether or not the download package contains a source file. It can be set to Yes or No.

Instruction Response Schema

The following schema shows the Instruction response.

<Instructions xmlns="Default XML namespace used for the XML document">
  <Package>
    <ID>"Package Unique ID"</ID>
    <Required>"Whether or not the download of this package is required"</Required>
    <Name>"Name of the package"</Name>
    <ShortDescription>"Short description of package"</ShortDescription>
    <LongDescription>"Long description of package"</LongDescription>
    <Flags>"Set of flags used to encode network connection-related constraints"</Flags>
    <StartTime UTC ="Whether or not UTC time">"Time when package should be downloaded and executed"</StartTime>
    <SourceFiles>"Does the download package contain a source file"</SourceFiles>
    <Recurrence>
      <Interval>"How often to download and execute the package"</Interval>
      <Behavior>"Download behavior of package"</Behavior>
    </Recurrence>
    <LocalDestination>"Where the package will be saved on client" </LocalDestination>
    <CommandLine>"Command line to execute for this package"</CommandLine>
    <PackageSize>"Size of the package, in bytes"</PackageSize>
  </Package>
</Instructions>

Instruction Response Sample

The following code example shows the instruction response from the server.

<Instructions xmlns="https://www.microsoft.com/DeviceManagement.xsd">
  <Package>
    <ID>9A437CA5-5B17-4486-9E87-260742074A72</ID>
    <Required>true</Required>
    <Name>sample directory download</Name>
    <ShortDescription>short of W directory</ShortDescription>
    <LongDescription>long of W directory</LongDescription>
    <Flags>03 00 00 00</Flags>
    <StartTime UTC="false">2002-08-29 00:00:00</StartTime>
    <SourceFiles>YES</SourceFiles>
    <Recurrence>
      <Interval>0000-00-01 00:00:00</Interval>
      <Behavior>Download and Execute</Behavior>
    </Recurrence>
    <LocalDestination>\temp</LocalDestination>
    <CommandLine>install.cab</CommandLine>
    <PackageSize>9448526</PackageSize>
  </Package>
</Instructions>

See Also

Concepts

Device Management Operation

Other Resources

Device Management Client Application Development