Compartilhar via

DMTASKINFO (Windows CE 5.0)

  • Artigo

Send Feedback

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

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 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

OS Versions: Windows CE .NET 4.2 and later.
Header: Devmgmt.h.

See Also

Device Management Client Registry Settings | API Access

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.