Task Scheduler error and success constants

If an error occurs, the Task Scheduler APIs can return one of the following error codes as an HRESULT value.

The constants that begin with SCHED_S_ are success constants, and the constants that begin with SCHED_E_ are error constants.

  HRESULT phrStatus;
  hr = pITask->GetStatus(&phrStatus);
  
  // Release the ITask interface.
  pITask->Release();
    
  switch(phrStatus)
  {
  case SCHED_S_TASK_READY:
       wprintf(L"  SCHED_S_TASK_READY\n");
       break;
  case SCHED_S_TASK_RUNNING:
       wprintf(L"  SCHED_S_TASK_RUNNING\n");
       break;

  //...
  }

Example from C/C++ code example: retrieving task status.

Note

Some Task Scheduler APIs can return system and network error codes (64 for example). You can check the definition of these types of error codes by using the net helpmsg command in the command prompt window. For example, the command net helpmsg 64 returns the message: The specified network name is no longer available.

For more info about events and error messages, see Events and Errors Message Center.

SCHED_E_SERVICE_NOT_LOCALSYSTEM

The Task Scheduler service must be configured to run in the System account to function properly. Individual tasks may be configured to run in other accounts.

#define SCHED_E_SERVICE_NOT_LOCALSYSTEM 6200L

SCHED_S_TASK_READY

The task is ready to run at its next scheduled time.

#define SCHED_S_TASK_READY _HRESULT_TYPEDEF_(0x00041300L)

SCHED_S_TASK_RUNNING

The task is currently running.

#define SCHED_S_TASK_RUNNING _HRESULT_TYPEDEF_(0x00041301L)

SCHED_S_TASK_DISABLED

The task will not run at the scheduled times because it has been disabled.

#define SCHED_S_TASK_DISABLED _HRESULT_TYPEDEF_(0x00041302L)

SCHED_S_TASK_HAS_NOT_RUN

The task has not yet run.

#define SCHED_S_TASK_HAS_NOT_RUN _HRESULT_TYPEDEF_(0x00041303L)

SCHED_S_TASK_NO_MORE_RUNS

There are no more runs scheduled for this task.

#define SCHED_S_TASK_NO_MORE_RUNS _HRESULT_TYPEDEF_(0x00041304L)

SCHED_S_TASK_NOT_SCHEDULED

One or more of the properties that are needed to run this task on a schedule have not been set.

#define SCHED_S_TASK_NOT_SCHEDULED _HRESULT_TYPEDEF_(0x00041305L)

SCHED_S_TASK_TERMINATED

The last run of the task was terminated by the user.

#define SCHED_S_TASK_TERMINATED _HRESULT_TYPEDEF_(0x00041306L)

SCHED_S_TASK_NO_VALID_TRIGGERS

Either the task has no triggers or the existing triggers are disabled or not set.

#define SCHED_S_TASK_NO_VALID_TRIGGERS _HRESULT_TYPEDEF_(0x00041307L)

SCHED_S_EVENT_TRIGGER

Event triggers don't have set run times.

#define SCHED_S_EVENT_TRIGGER _HRESULT_TYPEDEF_(0x00041308L)

SCHED_E_TRIGGER_NOT_FOUND

Trigger not found.

#define SCHED_E_TRIGGER_NOT_FOUND _HRESULT_TYPEDEF_(0x80041309L)

SCHED_E_TASK_NOT_READY

One or more of the properties that are needed to run this task have not been set.

#define SCHED_E_TASK_NOT_READY _HRESULT_TYPEDEF_(0x8004130AL)

SCHED_E_TASK_NOT_RUNNING

There is no running instance of the task.

#define SCHED_E_TASK_NOT_RUNNING _HRESULT_TYPEDEF_(0x8004130BL)

SCHED_E_SERVICE_NOT_INSTALLED

The Task Scheduler Service is not installed on this computer.

#define SCHED_E_SERVICE_NOT_INSTALLED _HRESULT_TYPEDEF_(0x8004130CL)

SCHED_E_CANNOT_OPEN_TASK

The task object could not be opened.

#define SCHED_E_CANNOT_OPEN_TASK _HRESULT_TYPEDEF_(0x8004130DL)

SCHED_E_INVALID_TASK

The object is either an invalid task object or is not a task object.

#define SCHED_E_INVALID_TASK _HRESULT_TYPEDEF_(0x8004130EL)

SCHED_E_ACCOUNT_INFORMATION_NOT_SET

No account information could be found in the Task Scheduler security database for the task indicated.

#define SCHED_E_ACCOUNT_INFORMATION_NOT_SET _HRESULT_TYPEDEF_(0x8004130FL)

SCHED_E_ACCOUNT_NAME_NOT_FOUND

Unable to establish existence of the account specified.

#define SCHED_E_ACCOUNT_NAME_NOT_FOUND _HRESULT_TYPEDEF_(0x80041310L)

SCHED_E_ACCOUNT_DBASE_CORRUPT

Corruption was detected in the Task Scheduler security database; the database has been reset.

#define SCHED_E_ACCOUNT_DBASE_CORRUPT _HRESULT_TYPEDEF_(0x80041311L)

SCHED_E_NO_SECURITY_SERVICES

Task Scheduler security services are available only on Windows NT.

#define SCHED_E_NO_SECURITY_SERVICES _HRESULT_TYPEDEF_(0x80041312L)

SCHED_E_UNKNOWN_OBJECT_VERSION

The task object version is either unsupported or invalid.

#define SCHED_E_UNKNOWN_OBJECT_VERSION _HRESULT_TYPEDEF_(0x80041313L)

SCHED_E_UNSUPPORTED_ACCOUNT_OPTION

The task has been configured with an unsupported combination of account settings and run time options.

#define SCHED_E_UNSUPPORTED_ACCOUNT_OPTION _HRESULT_TYPEDEF_(0x80041314L)

SCHED_E_SERVICE_NOT_RUNNING

The Task Scheduler Service is not running.

#define SCHED_E_SERVICE_NOT_RUNNING _HRESULT_TYPEDEF_(0x80041315L)

SCHED_E_UNEXPECTEDNODE

The task XML contains an unexpected node.

#define SCHED_E_UNEXPECTEDNODE _HRESULT_TYPEDEF_(0x80041316L)

SCHED_E_NAMESPACE

The task XML contains an element or attribute from an unexpected namespace.

#define SCHED_E_NAMESPACE _HRESULT_TYPEDEF_(0x80041317L)

SCHED_E_INVALIDVALUE

The task XML contains a value which is incorrectly formatted or out of range.

#define SCHED_E_INVALIDVALUE _HRESULT_TYPEDEF_(0x80041318L)

SCHED_E_MISSINGNODE

The task XML is missing a required element or attribute.

#define SCHED_E_MISSINGNODE _HRESULT_TYPEDEF_(0x80041319L)

SCHED_E_MALFORMEDXML

The task XML is malformed.

#define SCHED_E_MALFORMEDXML _HRESULT_TYPEDEF_(0x8004131AL)

SCHED_S_SOME_TRIGGERS_FAILED

The task is registered, but not all specified triggers will start the task, check task scheduler event log for detailed information.

#define SCHED_S_SOME_TRIGGERS_FAILED _HRESULT_TYPEDEF_(0x0004131BL)

SCHED_S_BATCH_LOGON_PROBLEM

The task is registered, but may fail to start. Batch logon privilege needs to be enabled for the task principal.

#define SCHED_S_BATCH_LOGON_PROBLEM _HRESULT_TYPEDEF_(0x0004131CL)

SCHED_E_TOO_MANY_NODES

The task XML contains too many nodes of the same type.

#define SCHED_E_TOO_MANY_NODES _HRESULT_TYPEDEF_(0x8004131DL)

SCHED_E_PAST_END_BOUNDARY

The task cannot be started after the trigger's end boundary.

#define SCHED_E_PAST_END_BOUNDARY _HRESULT_TYPEDEF_(0x8004131EL)

SCHED_E_ALREADY_RUNNING

An instance of this task is already running.

#define SCHED_E_ALREADY_RUNNING _HRESULT_TYPEDEF_(0x8004131FL)

SCHED_E_USER_NOT_LOGGED_ON

The task will not run because the user is not logged on.

#define SCHED_E_USER_NOT_LOGGED_ON _HRESULT_TYPEDEF_(0x80041320L)

SCHED_E_INVALID_TASK_HASH

The task image is corrupt or has been tampered with.

#define SCHED_E_INVALID_TASK_HASH _HRESULT_TYPEDEF_(0x80041321L)

SCHED_E_SERVICE_NOT_AVAILABLE

The Task Scheduler service is not available.

#define SCHED_E_SERVICE_NOT_AVAILABLE _HRESULT_TYPEDEF_(0x80041322L)

SCHED_E_SERVICE_TOO_BUSY

The Task Scheduler service is too busy to handle your request. Please try again later.

#define SCHED_E_SERVICE_TOO_BUSY _HRESULT_TYPEDEF_(0x80041323L)

SCHED_E_TASK_ATTEMPTED

The Task Scheduler service attempted to run the task, but the task did not run due to one of the constraints in the task definition.

#define SCHED_E_TASK_ATTEMPTED _HRESULT_TYPEDEF_(0x80041324L)

SCHED_S_TASK_QUEUED

The Task Scheduler service has asked the task to run.

#define SCHED_S_TASK_QUEUED _HRESULT_TYPEDEF_(0x00041325L)

SCHED_E_TASK_DISABLED

The task is disabled.

#define SCHED_E_TASK_DISABLED _HRESULT_TYPEDEF_(0x80041326L)

SCHED_E_TASK_NOT_V1_COMPAT

The task has properties that are not compatible with previous versions of Windows.

#define SCHED_E_TASK_NOT_V1_COMPAT _HRESULT_TYPEDEF_(0x80041327L)

SCHED_E_START_ON_DEMAND

The task settings do not allow the task to start on demand.

#define SCHED_E_START_ON_DEMAND _HRESULT_TYPEDEF_(0x80041328L)

SCHED_E_TASK_NOT_UBPM_COMPAT

The combination of properties that task is using is not compatible with the scheduling engine.

#define SCHED_E_TASK_NOT_UBPM_COMPAT _HRESULT_TYPEDEF_(0x80041329L)

SCHED_E_DEPRECATED_FEATURE_USED

The task definition uses a deprecated feature.

#define SCHED_E_DEPRECATED_FEATURE_USED _HRESULT_TYPEDEF_(0x80041330L)

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header WinError.h