Edit

Share via

ITaskSettings3::get_MaintenanceSettings method (taskschd.h)

  • Article

Gets or sets a pointer to pointer to an IMaintenanceSettings object that Task scheduler uses to perform a task during Automatic maintenance.

This property is read/write.

Syntax

HRESULT get_MaintenanceSettings(
  IMaintenanceSettings **ppMaintenanceSettings
);

Parameters

ppMaintenanceSettings

Return value

None

Remarks

When battery saver is on, Windows Task Scheduler tasks are triggered only if the task is:

  • Not set to Start the task only if the computer is idle... (task doesn't use IdleSettings)
  • Not set to run during automatic maintenance (task doesn't use MaintenanceSettings)
  • Is set to Run only when user is logged on (task LogonType is TASK_LOGON_INTERACTIVE_TOKEN or TASK_LOGON_GROUP)
All other triggers are delayed until battery saver is off. For more information about accessing battery saver status in your application, see SYSTEM_POWER_STATUS. For general information about battery saver, see battery saver (in the hardware component guidelines).

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header taskschd.h
Library Taskschd.lib
DLL Taskschd.dll

See also

ITaskSettings3