DMTASKINFO (Windows Embedded CE 6.0)

1/6/2010

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, stDeltaTime cannot 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 RetryTime value and MaxRetry value, 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 DMSINVRECORD that specifies the package ID and download information.

• pwzXml
  Reserved.

Requirements

See Also

Reference

Device Management Client Structures

Concepts

Device Management Client Registry Settings
API Access