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

This structure contains task information passed from the application to Dmsdklib.

Syntax 


typedef struct {
  DWORD 
dwSize
;
  SYSTEMTIME 
stStartTime
;
  SYSTEMTIME 
stDeltaTime
;
  SYSTEMTIME 
stRetryTime
;
  DWORD 
dwType
;
  DWORD 
dwMaxRetryTime
;
  DWORD 
dwFlags
;
  LPTSTR 
pwzRDN
;
  LPTSTR 
pwzURL
;
  LPTSTR 
pwzURLSig
;
  LPTSTR 
pwzMisc
;
  LPTSTR 
pwzData
;
  LPTSTR 
pwzXml
;
} DMTASKINFO, *PDMTASKINFO;

Members

dwSize

Specifies the size of the structure.

stStartTime

Specifies the start time, in UTC (GMT).

stDeltaTime

The time between the beginning of a successful attempt and the beginning of the next attempt. This is used for a recurrent task. If this parameter is equal to zero, the task is run only once.

For a recurrent task, stDeltaTimecannot be equal to zero.

stRetryTime

This parameter is reserved. The retry time of a task is the period between a failure and the next attempt. Windows Embedded CE uses a default value of 3 minutes. The default maximum number of retry times is 5. These default values can be changed using the RetryTimevalue and MaxRetryvalue, respectively, in HKEY_LOCAL_MACHINE\Comm\ApplicationDownload. For more information, see Device Management Client Registry Settings.

dwType

Specifies the type of task. The following table shows the different types of tasks.

Task Definition

DMSTASK_POLL

Polling task.

DMSTASK_DOWNLOAD

Download task.

DMSTASK_IMMEDIATE

Schedule the task immediately and ignore stStartTime.
dwMaxRetryTime

Specifies the default maximum number of retry times. This parameter is reserved. See stRetryTime.

dwFlags

Specifies the connection type that the task allows. The following table shows the different connection types allowed.

Connection type Description

ADL_SLOW_NETWORK

The operation can be performed over a slow connection.

ADL_FAST_NETWORK

The operation can be performed over a fast network.

ADL_NONPASSTHROUGH_ALLOWED (ADL_FAST_NETWORK | ADL_SLOW_NETWORK)

This operation can be performed by using something other than a desktop passthrough.

ADL_PASSTHROUGH

This operation can be performed over a desktop passthrough.

ADL_PASSTHROUGH_ONLY

This operation can be performed only over a desktop passthrough.

ADL_RECURRENT

This operation is performed repeatedly.

ADL_RECUR_EXEC_ONLY

The package is downloaded once, but executed recurrently in this operation.
pwzRDN

Reserved.

pwzURL

Reserved.

pwzURLSig

Reserved.

pwzMisc

Reserved.

pwzData

For download task, this should point to a structure of type DMSINVRECORDthat specifies the package ID and download information.

pwzXml

Reserved.

Requirements

Header devmgmt.h
Windows Embedded CE Windows CE .NET 4.2 and later

See Also