Enumerated Types

Enumerated Types


This section describes the Task Scheduler enumerated types.

TASK_TRIGGER_TYPE

typedef enum _TASK_TRIGGER_TYPE {
    TASK_TIME_TRIGGER_ONCE            = 0,
    TASK_TIME_TRIGGER_DAILY           = 1,
    TASK_TIME_TRIGGER_WEEKLY          = 2,
    TASK_TIME_TRIGGER_MONTHLYDATE     = 3,
    TASK_TIME_TRIGGER_MONTHLYDOW      = 4,
    TASK_EVENT_TRIGGER_ON_IDLE        = 5,
    TASK_EVENT_TRIGGER_AT_SYSTEMSTART = 6,
    TASK_EVENT_TRIGGER_AT_LOGON       = 7
} TASK_TRIGGER_TYPE, *PTASK_TRIGGER_TYPE;

Defines the type of trigger the task will use. This enumerated type is part of the TASK_TRIGGER structure. The trigger type determines when the task will run.

TASK_TIME_TRIGGER_ONCE
Trigger is set to run the task a single time.
TASK_TIME_TRIGGER_DAILY
Trigger is set to run the task on a daily interval.
TASK_TIME_TRIGGER_WEEKLY
Trigger is set to run the task on specific days of the week on a weekly interval.
TASK_TIME_TRIGGER_MONTHLYDATE
Trigger is set to run the task on a specific day(s) of the month.
TASK_TIME_TRIGGER_MONTHLYDOW
Trigger is set to run the task on specific days, weeks, and months.
TASK_EVENT_TRIGGER_ON_IDLE
Trigger is set to run the task when the system becomes idle (Windows 95 only).
TASK_EVENT_TRIGGER_AT_SYSTEMSTART
Trigger is set to run the task at system startup.
TASK_EVENT_TRIGGER_AT_LOGON
Trigger is set to run the task when a user logs on.

TASKPAGE

typedef enum  _TASKPAGE{
    TASKPAGE_TASK     = 0,
    TASKPAGE_SCHEDULE = 1,
    TASKPAGE_SETTINGS = 2
    }TASKPAGE;

Defines characteristics of a task object property. The enumeration values are used in the tpType parameter of the IProvideTaskPage::GetPage function.

TASKPAGE_TASK
Application name.
Parameters to be passed to the application.
Working directory.
Comment information.
Windows NT only Account name and password.
TASK_TRIGGER_FLAG_DISABLED flag.
TASKPAGE_SCHEDULE
Schedule properties for the task object. The user can create and delete task triggers from this page, and edit all of the properties for each of the triggers.
TASKPAGE_SETTINGS
TASK_FLAG_DELETE_WHEN_DONE flag.
MaxRunTime of the task.
Windows 95 only IdleWait.
Windows 95 only TASK_FLAG_START_ONLY_IF_IDLE flag.
Windows 95 only TASK_FLAG_KILL_ON_IDLE_END flag.
Windows 95 only TASK_FLAG_DONT_START_IF_ON_BATTERIES flag.
Windows 95 only TASK_FLAG_KILL_IF_GOING_ON_BATTERIES flag.

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.