using System; using System.ComponentModel; using System.Runtime.InteropServices; using System.Runtime.InteropServices.ComTypes; using System.Xml; using System.Xml.Schema; using System.Xml.Serialization; namespace Microsoft.Win32.TaskScheduler { #region Enumerations /// Defines what versions of Task Scheduler or the AT command that the task is compatible with. public enum TaskCompatibility { /// The task is compatible with the AT command. AT, /// The task is compatible with Task Scheduler 1.0 (Windows Server™ 2003, Windows® XP, or Windows® 2000). V1, /// The task is compatible with Task Scheduler 2.0 (Windows Vista™, Windows Server™ 2008). V2, /// The task is compatible with Task Scheduler 2.1 (Windows® 7, Windows Server™ 2008 R2). V2_1, /// The task is compatible with Task Scheduler 2.2 (Windows® 8.x, Windows Server™ 2012). V2_2 } /// Defines how the Task Scheduler service creates, updates, or disables the task. public enum TaskCreation { /// The Task Scheduler service registers the task as a new task. Create = 2, /// The Task Scheduler service either registers the task as a new task or as an updated version if the task already exists. Equivalent to Create | Update. CreateOrUpdate = 6, /// The Task Scheduler service registers the disabled task. A disabled task cannot run until it is enabled. For more information, see Enabled Property of TaskSettings and Enabled Property of RegisteredTask. Disable = 8, /// The Task Scheduler service is prevented from adding the allow access-control entry (ACE) for the context principal. When the TaskFolder.RegisterTaskDefinition or TaskFolder.RegisterTask functions are called with this flag to update a task, the Task Scheduler service does not add the ACE for the new context principal and does not remove the ACE from the old context principal. DontAddPrincipalAce = 0x10, /// The Task Scheduler service creates the task, but ignores the registration triggers in the task. By ignoring the registration triggers, the task will not execute when it is registered unless a time-based trigger causes it to execute on registration. IgnoreRegistrationTriggers = 0x20, /// The Task Scheduler service registers the task as an updated version of an existing task. When a task with a registration trigger is updated, the task will execute after the update occurs. Update = 4, /// The Task Scheduler service checks the syntax of the XML that describes the task but does not register the task. This constant cannot be combined with the Create, Update, or CreateOrUpdate values. ValidateOnly = 1 } /// Defines how the Task Scheduler handles existing instances of the task when it starts a new instance of the task. public enum TaskInstancesPolicy { /// Starts new instance while an existing instance is running. Parallel, /// Starts a new instance of the task after all other instances of the task are complete. Queue, /// Does not start a new instance if an existing instance of the task is running. IgnoreNew, /// Stops an existing instance of the task before it starts a new instance. StopExisting } /// Defines what logon technique is required to run a task. public enum TaskLogonType { /// The logon method is not specified. Used for non-NT credentials. None, /// Use a password for logging on the user. The password must be supplied at registration time. Password, /// Use an existing interactive token to run a task. The user must log on using a service for user (S4U) logon. When an S4U logon is used, no password is stored by the system and there is no access to either the network or to encrypted files. S4U, /// User must already be logged on. The task will be run only in an existing interactive session. InteractiveToken, /// Group activation. The groupId field specifies the group. Group, /// Indicates that a Local System, Local Service, or Network Service account is being used as a security context to run the task. ServiceAccount, /// First use the interactive token. If the user is not logged on (no interactive token is available), then the password is used. The password must be specified when a task is registered. This flag is not recommended for new tasks because it is less reliable than Password. InteractiveTokenOrPassword } /// Defines which privileges must be required for a secured task. public enum TaskPrincipalPrivilege { /// Required to create a primary token. User Right: Create a token object. SeCreateTokenPrivilege = 1, /// Required to assign the primary token of a process. User Right: Replace a process-level token. SeAssignPrimaryTokenPrivilege, /// Required to lock physical pages in memory. User Right: Lock pages in memory. SeLockMemoryPrivilege, /// Required to increase the quota assigned to a process. User Right: Adjust memory quotas for a process. SeIncreaseQuotaPrivilege, /// Required to read unsolicited input from a terminal device. User Right: Not applicable. SeUnsolicitedInputPrivilege, /// Required to create a computer account. User Right: Add workstations to domain. SeMachineAccountPrivilege, /// This privilege identifies its holder as part of the trusted computer base. Some trusted protected subsystems are granted this privilege. User Right: Act as part of the operating system. SeTcbPrivilege, /// Required to perform a number of security-related functions, such as controlling and viewing audit messages. This privilege identifies its holder as a security operator. User Right: Manage auditing and the security log. SeSecurityPrivilege, /// Required to take ownership of an object without being granted discretionary access. This privilege allows the owner value to be set only to those values that the holder may legitimately assign as the owner of an object. User Right: Take ownership of files or other objects. SeTakeOwnershipPrivilege, /// Required to load or unload a device driver. User Right: Load and unload device drivers. SeLoadDriverPrivilege, /// Required to gather profiling information for the entire system. User Right: Profile system performance. SeSystemProfilePrivilege, /// Required to modify the system time. User Right: Change the system time. SeSystemtimePrivilege, /// Required to gather profiling information for a single process. User Right: Profile single process. SeProfileSingleProcessPrivilege, /// Required to increase the base priority of a process. User Right: Increase scheduling priority. SeIncreaseBasePriorityPrivilege, /// Required to create a paging file. User Right: Create a pagefile. SeCreatePagefilePrivilege, /// Required to create a permanent object. User Right: Create permanent shared objects. SeCreatePermanentPrivilege, /// Required to perform backup operations. This privilege causes the system to grant all read access control to any file, regardless of the access control list (ACL) specified for the file. Any access request other than read is still evaluated with the ACL. This privilege is required by the RegSaveKey and RegSaveKeyExfunctions. The following access rights are granted if this privilege is held: READ_CONTROL, ACCESS_SYSTEM_SECURITY, FILE_GENERIC_READ, FILE_TRAVERSE. User Right: Back up files and directories. SeBackupPrivilege, /// Required to perform restore operations. This privilege causes the system to grant all write access control to any file, regardless of the ACL specified for the file. Any access request other than write is still evaluated with the ACL. Additionally, this privilege enables you to set any valid user or group security identifier (SID) as the owner of a file. This privilege is required by the RegLoadKey function. The following access rights are granted if this privilege is held: WRITE_DAC, WRITE_OWNER, ACCESS_SYSTEM_SECURITY, FILE_GENERIC_WRITE, FILE_ADD_FILE, FILE_ADD_SUBDIRECTORY, DELETE. User Right: Restore files and directories. SeRestorePrivilege, /// Required to shut down a local system. User Right: Shut down the system. SeShutdownPrivilege, /// Required to debug and adjust the memory of a process owned by another account. User Right: Debug programs. SeDebugPrivilege, /// Required to generate audit-log entries. Give this privilege to secure servers. User Right: Generate security audits. SeAuditPrivilege, /// Required to modify the nonvolatile RAM of systems that use this type of memory to store configuration information. User Right: Modify firmware environment values. SeSystemEnvironmentPrivilege, /// Required to receive notifications of changes to files or directories. This privilege also causes the system to skip all traversal access checks. It is enabled by default for all users. User Right: Bypass traverse checking. SeChangeNotifyPrivilege, /// Required to shut down a system by using a network request. User Right: Force shutdown from a remote system. SeRemoteShutdownPrivilege, /// Required to undock a laptop. User Right: Remove computer from docking station. SeUndockPrivilege, /// Required for a domain controller to use the LDAP directory synchronization services. This privilege allows the holder to read all objects and properties in the directory, regardless of the protection on the objects and properties. By default, it is assigned to the Administrator and LocalSystem accounts on domain controllers. User Right: Synchronize directory service data. SeSyncAgentPrivilege, /// Required to mark user and computer accounts as trusted for delegation. User Right: Enable computer and user accounts to be trusted for delegation. SeEnableDelegationPrivilege, /// Required to enable volume management privileges. User Right: Manage the files on a volume. SeManageVolumePrivilege, /// Required to impersonate. User Right: Impersonate a client after authentication. Windows XP/2000: This privilege is not supported. Note that this value is supported starting with Windows Server 2003, Windows XP with SP2, and Windows 2000 with SP4. SeImpersonatePrivilege, /// Required to create named file mapping objects in the global namespace during Terminal Services sessions. This privilege is enabled by default for administrators, services, and the local system account. User Right: Create global objects. Windows XP/2000: This privilege is not supported. Note that this value is supported starting with Windows Server 2003, Windows XP with SP2, and Windows 2000 with SP4. SeCreateGlobalPrivilege, /// Required to access Credential Manager as a trusted caller. User Right: Access Credential Manager as a trusted caller. SeTrustedCredManAccessPrivilege, /// Required to modify the mandatory integrity level of an object. User Right: Modify an object label. SeRelabelPrivilege, /// Required to allocate more memory for applications that run in the context of users. User Right: Increase a process working set. SeIncreaseWorkingSetPrivilege, /// Required to adjust the time zone associated with the computer's internal clock. User Right: Change the time zone. SeTimeZonePrivilege, /// Required to create a symbolic link. User Right: Create symbolic links. SeCreateSymbolicLinkPrivilege } /// Defines the types of process security identifier (SID) that can be used by tasks. These changes are used to specify the type of process SID in the IPrincipal2 interface. public enum TaskProcessTokenSidType { /// No changes will be made to the process token groups list. None = 0, /// A task SID that is derived from the task name will be added to the process token groups list, and the token default discretionary access control list (DACL) will be modified to allow only the task SID and local system full control and the account SID read control. Unrestricted = 1, /// A Task Scheduler will apply default settings to the task process. Default = 2 } /// Defines how a task is run. [Flags] public enum TaskRunFlags { /// The task is run with all flags ignored. NoFlags = 0, /// The task is run as the user who is calling the Run method. AsSelf = 1, /// The task is run regardless of constraints such as "do not run on batteries" or "run only if idle". IgnoreConstraints = 2, /// The task is run using a terminal server session identifier. UseSessionId = 4, /// The task is run using a security identifier. UserSID = 8 } /// Defines LUA elevation flags that specify with what privilege level the task will be run. public enum TaskRunLevel { /// Tasks will be run with the least privileges. [XmlEnum("LeastPrivilege")] LUA, /// Tasks will be run with the highest privileges. [XmlEnum("HighestAvailable")] Highest } /// Defines what kind of Terminal Server session state change you can use to trigger a task to start. These changes are used to specify the type of state change in the SessionStateChangeTrigger. public enum TaskSessionStateChangeType { /// Terminal Server console connection state change. For example, when you connect to a user session on the local computer by switching users on the computer. ConsoleConnect = 1, /// Terminal Server console disconnection state change. For example, when you disconnect to a user session on the local computer by switching users on the computer. ConsoleDisconnect = 2, /// Terminal Server remote connection state change. For example, when a user connects to a user session by using the Remote Desktop Connection program from a remote computer. RemoteConnect = 3, /// Terminal Server remote disconnection state change. For example, when a user disconnects from a user session while using the Remote Desktop Connection program from a remote computer. RemoteDisconnect = 4, /// Terminal Server session locked state change. For example, this state change causes the task to run when the computer is locked. SessionLock = 7, /// Terminal Server session unlocked state change. For example, this state change causes the task to run when the computer is unlocked. SessionUnlock = 8 } /***** WAITING TO DETERMINE USE CASE ***** /// /// Success and error codes that some methods will expose through . /// public enum TaskResultCode { /// The task is ready to run at its next scheduled time. TaskReady = 0x00041300, /// The task is currently running. TaskRunning = 0x00041301, /// The task will not run at the scheduled times because it has been disabled. TaskDisabled = 0x00041302, /// The task has not yet run. TaskHasNotRun = 0x00041303, /// There are no more runs scheduled for this task. TaskNoMoreRuns = 0x00041304, /// One or more of the properties that are needed to run this task on a schedule have not been set. TaskNotScheduled = 0x00041305, /// The last run of the task was terminated by the user. TaskTerminated = 0x00041306, /// Either the task has no triggers or the existing triggers are disabled or not set. TaskNoValidTriggers = 0x00041307, /// Event triggers do not have set run times. EventTrigger = 0x00041308, /// A task's trigger is not found. TriggerNotFound = 0x80041309, /// One or more of the properties required to run this task have not been set. TaskNotReady = 0x8004130A, /// There is no running instance of the task. TaskNotRunning = 0x8004130B, /// The Task Scheduler service is not installed on this computer. ServiceNotInstalled = 0x8004130C, /// The task object could not be opened. CannotOpenTask = 0x8004130D, /// The object is either an invalid task object or is not a task object. InvalidTask = 0x8004130E, /// No account information could be found in the Task Scheduler security database for the task indicated. AccountInformationNotSet = 0x8004130F, /// Unable to establish existence of the account specified. AccountNameNotFound = 0x80041310, /// Corruption was detected in the Task Scheduler security database; the database has been reset. AccountDbaseCorrupt = 0x80041311, /// Task Scheduler security services are available only on Windows NT. NoSecurityServices = 0x80041312, /// The task object version is either unsupported or invalid. UnknownObjectVersion = 0x80041313, /// The task has been configured with an unsupported combination of account settings and run time options. UnsupportedAccountOption = 0x80041314, /// The Task Scheduler Service is not running. ServiceNotRunning = 0x80041315, /// The task XML contains an unexpected node. UnexpectedNode = 0x80041316, /// The task XML contains an element or attribute from an unexpected namespace. Namespace = 0x80041317, /// The task XML contains a value which is incorrectly formatted or out of range. InvalidValue = 0x80041318, /// The task XML is missing a required element or attribute. MissingNode = 0x80041319, /// The task XML is malformed. MalformedXml = 0x8004131A, /// The task is registered, but not all specified triggers will start the task. SomeTriggersFailed = 0x0004131B, /// The task is registered, but may fail to start. Batch logon privilege needs to be enabled for the task principal. BatchLogonProblem = 0x0004131C, /// The task XML contains too many nodes of the same type. TooManyNodes = 0x8004131D, /// The task cannot be started after the trigger end boundary. PastEndBoundary = 0x8004131E, /// An instance of this task is already running. AlreadyRunning = 0x8004131F, /// The task will not run because the user is not logged on. UserNotLoggedOn = 0x80041320, /// The task image is corrupt or has been tampered with. InvalidTaskHash = 0x80041321, /// The Task Scheduler service is not available. ServiceNotAvailable = 0x80041322, /// The Task Scheduler service is too busy to handle your request. Please try again later. ServiceTooBusy = 0x80041323, /// 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. TaskAttempted = 0x80041324, /// The Task Scheduler service has asked the task to run. TaskQueued = 0x00041325, /// The task is disabled. TaskDisabled = 0x80041326, /// The task has properties that are not compatible with earlier versions of Windows. TaskNotV1Compatible = 0x80041327, /// The task settings do not allow the task to start on demand. StartOnDemand = 0x80041328, } */ /// Defines the different states that a registered task can be in. public enum TaskState { /// The state of the task is unknown. Unknown, /// The task is registered but is disabled and no instances of the task are queued or running. The task cannot be run until it is enabled. Disabled, /// Instances of the task are queued. Queued, /// The task is ready to be executed, but no instances are queued or running. Ready, /// One or more instances of the task is running. Running } #endregion Enumerations /// /// Specifies how the Task Scheduler performs tasks when the computer is in an idle condition. For information about idle conditions, see Task Idle Conditions. /// public sealed class IdleSettings : IDisposable { private V1Interop.ITask v1Task = null; private V2Interop.IIdleSettings v2Settings; internal IdleSettings(V2Interop.IIdleSettings iSettings) { v2Settings = iSettings; } internal IdleSettings(TaskScheduler.V1Interop.ITask iTask) { v1Task = iTask; } /// /// Gets or sets a value that indicates the amount of time that the computer must be in an idle state before the task is run. /// /// /// A value that indicates the amount of time that the computer must be in an idle state before the task is run. The minimum value is one minute. If this value is TimeSpan.Zero, then the delay will be set to the default of 10 minutes. /// [DefaultValue(typeof(TimeSpan), "00:10:00")] public TimeSpan IdleDuration { get { if (v2Settings != null) return Task.StringToTimeSpan(v2Settings.IdleDuration); ushort idleMin, deadMin; v1Task.GetIdleWait(out idleMin, out deadMin); return TimeSpan.FromMinutes((double)deadMin); } set { if (v2Settings != null) { if (value != TimeSpan.Zero && value < TimeSpan.FromMinutes(1)) throw new ArgumentOutOfRangeException(); v2Settings.IdleDuration = Task.TimeSpanToString(value); } else { v1Task.SetIdleWait((ushort)this.WaitTimeout.TotalMinutes, (ushort)value.TotalMinutes); } } } /// /// Gets or sets a Boolean value that indicates whether the task is restarted when the computer cycles into an idle condition more than once. /// [DefaultValue(false)] public bool RestartOnIdle { get { if (v2Settings != null) return v2Settings.RestartOnIdle; return (v1Task.GetFlags() & V1Interop.TaskFlags.RestartOnIdleResume) == V1Interop.TaskFlags.RestartOnIdleResume; } set { if (v2Settings != null) v2Settings.RestartOnIdle = value; else { V1Interop.TaskFlags flags = v1Task.GetFlags(); if (value) v1Task.SetFlags(flags |= V1Interop.TaskFlags.RestartOnIdleResume); else v1Task.SetFlags(flags &= ~V1Interop.TaskFlags.RestartOnIdleResume); } } } /// /// Gets or sets a Boolean value that indicates that the Task Scheduler will terminate the task if the idle condition ends before the task is completed. /// [DefaultValue(true)] public bool StopOnIdleEnd { get { if (v2Settings != null) return v2Settings.StopOnIdleEnd; return (v1Task.GetFlags() & V1Interop.TaskFlags.KillOnIdleEnd) == V1Interop.TaskFlags.KillOnIdleEnd; } set { if (v2Settings != null) v2Settings.StopOnIdleEnd = value; else { V1Interop.TaskFlags flags = v1Task.GetFlags(); if (value) v1Task.SetFlags(flags |= V1Interop.TaskFlags.KillOnIdleEnd); else v1Task.SetFlags(flags &= ~V1Interop.TaskFlags.KillOnIdleEnd); } } } /// /// Gets or sets a value that indicates the amount of time that the Task Scheduler will wait for an idle condition to occur. If no value is specified for this property, then the Task Scheduler service will wait indefinitely for an idle condition to occur. /// /// /// A value that indicates the amount of time that the Task Scheduler will wait for an idle condition to occur. The minimum time allowed is 1 minute. If this value is TimeSpan.Zero, then the delay will be set to the default of 1 hour. /// [DefaultValue(typeof(TimeSpan), "01:00:00")] public TimeSpan WaitTimeout { get { if (v2Settings != null) return Task.StringToTimeSpan(v2Settings.WaitTimeout); ushort idleMin, deadMin; v1Task.GetIdleWait(out idleMin, out deadMin); return TimeSpan.FromMinutes(idleMin); } set { if (v2Settings != null) { if (value != TimeSpan.Zero && value < TimeSpan.FromMinutes(1)) throw new ArgumentOutOfRangeException(); v2Settings.WaitTimeout = Task.TimeSpanToString(value); } else { v1Task.SetIdleWait((ushort)value.TotalMinutes, (ushort)this.IdleDuration.TotalMinutes); } } } /// /// Releases all resources used by this class. /// public void Dispose() { if (v2Settings != null) Marshal.ReleaseComObject(v2Settings); v1Task = null; } /// /// Returns a that represents this instance. /// /// /// A that represents this instance. /// public override string ToString() { if (v2Settings != null || v1Task != null) return DebugHelper.GetDebugString(this); return base.ToString(); } } internal static class DebugHelper { public static string GetDebugString(object inst) { #if DEBUG var sb = new System.Text.StringBuilder(); foreach (var pi in inst.GetType().GetProperties(System.Reflection.BindingFlags.Public|System.Reflection.BindingFlags.Instance|System.Reflection.BindingFlags.DeclaredOnly)) { if (pi.Name.StartsWith("Xml")) continue; var outval = pi.GetValue(inst, null); if (outval != null) { var defval = XmlSerializationHelper.GetDefaultValue(pi); if (!outval.Equals(defval)) { var s = string.Format("{0}:{1}", pi.Name, outval); if (s.Length > 30) s = s.Remove(30); sb.Append(s + "; "); } } } return sb.ToString(); #else return inst.GetType().ToString(); #endif } } /// /// Specifies the task settings the Task scheduler will use to start task during Automatic maintenance. /// [XmlType(IncludeInSchema = false)] public sealed class MaintenanceSettings : IDisposable { private V2Interop.ITaskSettings3 iSettings = null; private V2Interop.IMaintenanceSettings iMaintSettings = null; internal MaintenanceSettings(V2Interop.ITaskSettings3 iSettings3) { iSettings = iSettings3; if (iSettings3 != null) iMaintSettings = iSettings.MaintenanceSettings; } /// /// Gets or sets the amount of time after which the Task scheduler attempts to run the task during emergency Automatic maintenance, if the task failed to complete during regular Automatic maintenance. The minimum value is one day. The value of the property should be greater than the value of the property. If the deadline is not specified the task will not be started during emergency Automatic maintenance. /// /// Property set for a task on a Task Scheduler version prior to 2.2. [DefaultValue(typeof(TimeSpan), "00:00:00")] public TimeSpan Deadline { get { if (iMaintSettings != null) return Task.StringToTimeSpan(iMaintSettings.Deadline); return TimeSpan.Zero; } set { if (iSettings != null) { if (iMaintSettings == null && value != TimeSpan.Zero) iMaintSettings = iSettings.CreateMaintenanceSettings(); if (iMaintSettings != null) iMaintSettings.Deadline = Task.TimeSpanToString(value); } else throw new NotSupportedPriorToException(TaskCompatibility.V2_2); } } /// /// Gets or sets a valud indicating whether the Task Scheduler must start the task during the Automatic maintenance in exclusive mode. The exclusivity is guaranteed only between other maintenance tasks and doesn't grant any ordering priority of the task. If exclusivity is not specified, the task is started in parallel with other maintenance tasks. /// /// Property set for a task on a Task Scheduler version prior to 2.2. [DefaultValue(false)] public bool Exclusive { get { if (iMaintSettings != null) return iMaintSettings.Exclusive; return false; } set { if (iSettings != null) { if (iMaintSettings == null && value != false) iMaintSettings = iSettings.CreateMaintenanceSettings(); if (iMaintSettings != null) iMaintSettings.Exclusive = value; } else throw new NotSupportedPriorToException(TaskCompatibility.V2_2); } } /// /// Gets or sets the amount of time the task needs to be started during Automatic maintenance. The minimum value is one minute. /// /// Property set for a task on a Task Scheduler version prior to 2.2. [DefaultValue(typeof(TimeSpan), "00:00:00")] public TimeSpan Period { get { if (iMaintSettings != null) return Task.StringToTimeSpan(iMaintSettings.Period); return TimeSpan.Zero; } set { if (iSettings != null) { if (iMaintSettings == null && value != TimeSpan.Zero) iMaintSettings = iSettings.CreateMaintenanceSettings(); if (iMaintSettings != null) iMaintSettings.Period = Task.TimeSpanToString(value); } else throw new NotSupportedPriorToException(TaskCompatibility.V2_2); } } /// /// Releases all resources used by this class. /// public void Dispose() { if (iMaintSettings != null) Marshal.ReleaseComObject(iMaintSettings); } /// /// Returns a that represents this instance. /// /// /// A that represents this instance. /// public override string ToString() { if (iMaintSettings != null) return DebugHelper.GetDebugString(this); return base.ToString(); } internal bool IsSet() { return (iMaintSettings != null && (iMaintSettings.Period != null || iMaintSettings.Deadline != null || iMaintSettings.Exclusive == true)); } } /// /// Provides the settings that the Task Scheduler service uses to obtain a network profile. /// [XmlType(IncludeInSchema = false)] public sealed class NetworkSettings : IDisposable { private V2Interop.INetworkSettings v2Settings = null; internal NetworkSettings(V2Interop.INetworkSettings iSettings) { v2Settings = iSettings; } /// /// Gets or sets a GUID value that identifies a network profile. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(typeof(Guid), "00000000-0000-0000-0000-000000000000")] public Guid Id { get { string id = null; if (v2Settings != null) id = v2Settings.Id; return string.IsNullOrEmpty(id) ? Guid.Empty : new Guid(id); } set { if (v2Settings != null) v2Settings.Id = value == Guid.Empty ? null : value.ToString(); else throw new NotV1SupportedException(); } } /// /// Gets or sets the name of a network profile. The name is used for display purposes. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(null)] public string Name { get { if (v2Settings != null) return v2Settings.Name; return null; } set { if (v2Settings != null) v2Settings.Name = value; else throw new NotV1SupportedException(); } } /// /// Releases all resources used by this class. /// public void Dispose() { if (v2Settings != null) Marshal.ReleaseComObject(v2Settings); } internal bool IsSet() { return (v2Settings != null && (!string.IsNullOrEmpty(v2Settings.Id) || !string.IsNullOrEmpty(v2Settings.Name))); } /// /// Returns a that represents this instance. /// /// /// A that represents this instance. /// public override string ToString() { if (v2Settings != null) return DebugHelper.GetDebugString(this); return base.ToString(); } } /// /// Provides the methods to get information from and control a running task. /// [XmlType(IncludeInSchema = false)] public sealed class RunningTask : Task { private TaskScheduler.V2Interop.IRunningTask v2RunningTask; internal RunningTask(TaskService svc, V2Interop.IRegisteredTask iTask, V2Interop.IRunningTask iRunningTask) : base(svc, iTask) { v2RunningTask = iRunningTask; } internal RunningTask(TaskService svc, V1Interop.ITask iTask) : base(svc, iTask) { } /// /// Gets the name of the current action that the running task is performing. /// public string CurrentAction { get { if (v2RunningTask != null) return v2RunningTask.CurrentAction; return base.v1Task.GetApplicationName(); } } /// /// Gets the process ID for the engine (process) which is running the task. /// /// Not supported under Task Scheduler 1.0. public uint EnginePID { get { if (v2RunningTask != null) return v2RunningTask.EnginePID; throw new NotV1SupportedException(); } } /// /// Gets the GUID identifier for this instance of the task. /// public Guid InstanceGuid { get { if (v2RunningTask != null) return new Guid(v2RunningTask.InstanceGuid); return Guid.Empty; } } /// /// Gets the operational state of the running task. /// public override TaskState State { get { if (v2RunningTask != null) return v2RunningTask.State; return base.State; } } /// /// Releases all resources used by this class. /// public new void Dispose() { base.Dispose(); if (v2RunningTask != null) Marshal.ReleaseComObject(v2RunningTask); } /// /// Refreshes all of the local instance variables of the task. /// public void Refresh() { if (v2RunningTask != null) v2RunningTask.Refresh(); } } /// /// Provides the methods that are used to run the task immediately, get any running instances of the task, get or set the credentials that are used to register the task, and the properties that describe the task. /// [XmlType(IncludeInSchema = false)] public class Task : IDisposable { internal V1Interop.ITask v1Task; private static readonly DateTime v2InvalidDate = new DateTime(1899, 12, 30); private static readonly int osLibMinorVer = GetOSLibraryMinorVersion(); internal const System.Security.AccessControl.AccessControlSections defaultAccessControlSections = System.Security.AccessControl.AccessControlSections.Owner | System.Security.AccessControl.AccessControlSections.Group | System.Security.AccessControl.AccessControlSections.Access; internal const System.Security.AccessControl.SecurityInfos defaultSecurityInfosSections = System.Security.AccessControl.SecurityInfos.Owner | System.Security.AccessControl.SecurityInfos.Group | System.Security.AccessControl.SecurityInfos.DiscretionaryAcl; private V2Interop.IRegisteredTask v2Task; private TaskDefinition myTD; internal Task(TaskService svc, TaskScheduler.V1Interop.ITask iTask) { this.TaskService = svc; v1Task = iTask; this.ReadOnly = false; } internal Task(TaskService svc, TaskScheduler.V2Interop.IRegisteredTask iTask, TaskScheduler.V2Interop.ITaskDefinition iDef = null) { this.TaskService = svc; v2Task = iTask; if (iDef != null) myTD = new TaskDefinition(iDef); this.ReadOnly = false; } /// /// Gets the definition of the task. /// public TaskDefinition Definition { get { if (myTD == null) { if (v2Task != null) myTD = new TaskDefinition(GetV2Definition(this.TaskService, v2Task, true)); else myTD = new TaskDefinition(v1Task, this.Name); } return myTD; } } /// /// Gets or sets a Boolean value that indicates if the registered task is enabled. /// /// As of version 1.8.1, under V1 systems (prior to Vista), this property will immediately update the Disabled state and re-save the current task. If changes have been made to the , then those changes will be saved. public bool Enabled { get { if (v2Task != null) return v2Task.Enabled; return (v1Task.GetFlags() & V1Interop.TaskFlags.Disabled) != V1Interop.TaskFlags.Disabled; } set { if (v2Task != null) v2Task.Enabled = value; else { V1Interop.TaskFlags flags = v1Task.GetFlags(); if (!value) v1Task.SetFlags(flags |= V1Interop.TaskFlags.Disabled); else v1Task.SetFlags(flags &= ~V1Interop.TaskFlags.Disabled); this.Definition.V1Save(null); } } } /// /// Gets an instance of the parent folder. /// /// /// A object representing the parent folder of this task. /// public TaskFolder Folder { get { if (v2Task == null) return this.TaskService.RootFolder; string path = v2Task.Path; string parentPath = System.IO.Path.GetDirectoryName(path); if (string.IsNullOrEmpty(parentPath)) return null; return this.TaskService.GetFolder(parentPath); } } /// /// Gets a value indicating whether this task instance is active. /// /// /// true if this task instance is active; otherwise, false. /// public bool IsActive { get { DateTime now = DateTime.Now; if (this.Definition.Settings.Enabled) { foreach (Trigger trigger in this.Definition.Triggers) { if ((trigger != null && trigger.Enabled && (now >= trigger.StartBoundary)) && (now < trigger.EndBoundary)) { if (!(trigger is ICalendarTrigger)) return true; if (DateTime.MinValue != this.NextRunTime) return true; } } } return false; } } /// /// Gets the time the registered task was last run. /// /// Returns if there are no prior run times. public DateTime LastRunTime { get { if (v2Task != null) { DateTime dt = v2Task.LastRunTime; return dt == v2InvalidDate ? DateTime.MinValue : dt; } return v1Task.GetMostRecentRunTime(); } } /// /// Gets the results that were returned the last time the registered task was run. /// public int LastTaskResult { get { if (v2Task != null) return v2Task.LastTaskResult; return (int)v1Task.GetExitCode(); } } /// /// Gets the name of the registered task. /// public string Name { get { if (v2Task != null) return v2Task.Name; return System.IO.Path.GetFileNameWithoutExtension(GetV1Path(v1Task)); } } /// /// Gets the time when the registered task is next scheduled to run. /// /// Returns if there are no future run times. /// /// Potentially breaking change in release 1.8.2. For Task Scheduler 2.0, the return value prior to 1.8.2 would be Dec 30, 1899 /// if there were no future run times. For 1.0, that value would have been DateTime.MinValue. In release 1.8.2 and later, all /// versions will return DateTime.MinValue if there are no future run times. While this is different from the native 2.0 /// library, it was deemed more appropriate to have consistency between the two libraries and with other .NET libraries. /// public DateTime NextRunTime { get { if (v2Task != null) { DateTime ret = v2Task.NextRunTime; if (ret == DateTime.MinValue || ret == v2InvalidDate) { DateTime[] nrts = this.GetRunTimes(DateTime.Now, DateTime.MaxValue, 1); ret = nrts.Length > 0 ? nrts[0] : DateTime.MinValue; } return ret == v2InvalidDate ? DateTime.MinValue : ret; } return v1Task.GetNextRunTime(); } } /// /// Gets the number of times the registered task has missed a scheduled run. /// /// Not supported under Task Scheduler 1.0. public int NumberOfMissedRuns { get { if (v2Task != null) return v2Task.NumberOfMissedRuns; throw new NotV1SupportedException(); } } /// /// Gets the path to where the registered task is stored. /// public string Path { get { if (v2Task != null) return v2Task.Path; return GetV1Path(v1Task); } } /// /// Gets a value indicating whether this task is read only. Only available if is true. /// /// /// true if read only; otherwise, false. /// public bool ReadOnly { get; internal set; } /// /// Gets or sets the security descriptor for the task. /// /// The security descriptor. [Obsolete("This property will be removed in deference to the GetAccessControl, GetSecurityDescriptorSddlForm, SetAccessControl and SetSecurityDescriptorSddlForm methods.")] public System.Security.AccessControl.GenericSecurityDescriptor SecurityDescriptor { get { string sddl = GetSecurityDescriptorSddlForm(); return new System.Security.AccessControl.RawSecurityDescriptor(sddl); } set { SetSecurityDescriptorSddlForm(value.GetSddlForm(Task.defaultAccessControlSections)); } } /// /// Gets the operational state of the registered task. /// public virtual TaskState State { get { if (v2Task != null) return v2Task.State; V1Reactivate(); if (!this.Enabled) return TaskState.Disabled; switch (v1Task.GetStatus()) { case V1Interop.TaskStatus.Ready: case V1Interop.TaskStatus.NeverRun: case V1Interop.TaskStatus.NoMoreRuns: case V1Interop.TaskStatus.Terminated: return TaskState.Ready; case V1Interop.TaskStatus.Running: return TaskState.Running; case V1Interop.TaskStatus.Disabled: return TaskState.Disabled; case V1Interop.TaskStatus.NotScheduled: case V1Interop.TaskStatus.NoTriggers: case V1Interop.TaskStatus.NoTriggerTime: default: return TaskState.Unknown; } } } /// /// Gets or sets the that manages this task. /// /// The task service. public TaskService TaskService { get; private set; } /// /// Gets the XML-formatted registration information for the registered task. /// public string Xml { get { if (v2Task != null) return v2Task.Xml; return this.Definition.XmlText; } } /// /// Releases all resources used by this class. /// public void Dispose() { if (v2Task != null) Marshal.ReleaseComObject(v2Task); v1Task = null; } /// /// Exports the task to the specified file in XML. /// /// Name of the output file. public void Export(string outputFileName) { System.IO.File.WriteAllText(outputFileName, this.Xml, System.Text.Encoding.Unicode); } /// /// Gets a object that encapsulates the specified type of access control list (ACL) entries for the task described by the current object. /// /// A object that encapsulates the access control rules for the current task. public TaskSecurity GetAccessControl() { return GetAccessControl(Task.defaultAccessControlSections); } /// /// Gets a object that encapsulates the specified type of access control list (ACL) entries for the task described by the current object. /// /// One of the values that specifies which group of access control entries to retrieve. /// A object that encapsulates the access control rules for the current task. public TaskSecurity GetAccessControl(System.Security.AccessControl.AccessControlSections includeSections) { return new TaskSecurity(this, includeSections); } /// /// Gets all instances of the currently running registered task. /// /// A with all instances of current task. /// Not supported under Task Scheduler 1.0. public RunningTaskCollection GetInstances() { if (v2Task != null) return new RunningTaskCollection(this.TaskService, v2Task.GetInstances(0)); throw new NotV1SupportedException(); } /// /// Gets the times that the registered task is scheduled to run during a specified time. /// /// The starting time for the query. /// The ending time for the query. /// The requested number of runs. A value of 0 will return all times requested. /// The scheduled times that the task will run. public DateTime[] GetRunTimes(DateTime start, DateTime end, uint count = 0) { const ushort TASK_MAX_RUN_TIMES = 1440; Microsoft.Win32.NativeMethods.SYSTEMTIME stStart = start; Microsoft.Win32.NativeMethods.SYSTEMTIME stEnd = end; IntPtr runTimes = IntPtr.Zero; DateTime[] ret = new DateTime[0]; try { if (v2Task != null) v2Task.GetRunTimes(ref stStart, ref stEnd, ref count, ref runTimes); else { ushort count1 = (count > 0 && count <= TASK_MAX_RUN_TIMES) ? (ushort)count : TASK_MAX_RUN_TIMES; v1Task.GetRunTimes(ref stStart, ref stEnd, ref count1, ref runTimes); count = count1; } ret = InteropUtil.ToArray(runTimes, (int)count); } catch (Exception ex) { System.Diagnostics.Debug.WriteLine(string.Format("Task.GetRunTimes failed: Error {0}.", ex)); } finally { Marshal.FreeCoTaskMem(runTimes); } System.Diagnostics.Debug.WriteLine(string.Format("Task.GetRunTimes ({0}): Returned {1} items from {2} to {3}.", v2Task != null ? "V2" : "V1", count, stStart, stEnd)); return ret; } /// /// Gets the security descriptor for the task. Not available to Task Scheduler 1.0. /// /// Section(s) of the security descriptor to return. /// The security descriptor for the task. /// Not supported under Task Scheduler 1.0. public string GetSecurityDescriptorSddlForm(System.Security.AccessControl.SecurityInfos includeSections = Task.defaultSecurityInfosSections) { if (v2Task != null) return v2Task.GetSecurityDescriptor((int)includeSections); throw new NotV1SupportedException(); } /// /// Updates the task with any changes made to the by calling from the currently registered folder using the currently registered name. /// /// Thrown if task was previously registered with a password. public void RegisterChanges() { if (this.Definition.Principal.LogonType == TaskLogonType.InteractiveTokenOrPassword || this.Definition.Principal.LogonType == TaskLogonType.Password) throw new System.Security.SecurityException("Tasks which have been registered previously with stored passwords must use the TaskFolder.RegisterTaskDefinition method for updates."); TaskService.GetFolder(System.IO.Path.GetDirectoryName(this.Path)).RegisterTaskDefinition(this.Name, this.Definition); } /// /// Runs the registered task immediately. /// /// The parameters used as values in the task actions. /// A instance that defines the new instance of the task. public RunningTask Run(params string[] parameters) { if (v2Task != null) { if (parameters != null && parameters.Length > 32) throw new ArgumentOutOfRangeException("parameters", "A maximum of 32 values is allowed."); return new RunningTask(this.TaskService, this.v2Task, v2Task.Run(parameters)); } v1Task.Run(); return new RunningTask(this.TaskService, this.v1Task); } /// /// Runs the registered task immediately using specified flags and a session identifier. /// /// Defines how the task is run. /// The terminal server session in which you want to start the task. /// The user for which the task runs. /// The parameters used as values in the task actions. /// A instance that defines the new instance of the task. /// Not supported under Task Scheduler 1.0. public RunningTask RunEx(TaskRunFlags flags, int sessionID, string user, params string[] parameters) { if (v2Task != null) return new RunningTask(this.TaskService, this.v2Task, v2Task.RunEx(parameters, (int)flags, sessionID, user)); throw new NotV1SupportedException(); } /// /// Applies access control list (ACL) entries described by a object to the file described by the current object. /// /// A object that describes an access control list (ACL) entry to apply to the current task. public void SetAccessControl(TaskSecurity taskSecurity) { taskSecurity.Persist(this); } /// /// Sets the security descriptor for the task. Not available to Task Scheduler 1.0. /// /// The security descriptor for the task. /// Section(s) of the security descriptor to set. /// Not supported under Task Scheduler 1.0. public void SetSecurityDescriptorSddlForm(string sddlForm, System.Security.AccessControl.SecurityInfos includeSections = Task.defaultSecurityInfosSections) { if (v2Task != null) v2Task.SetSecurityDescriptor(sddlForm, (int)includeSections); else throw new NotV1SupportedException(); } /// /// Dynamically tries to load the assembly for the editor and displays it as editable for this task. /// /// true if editor returns with Ok response; false otherwise. /// The Microsoft.Win32.TaskSchedulerEditor.dll assembly must reside in the same directory as the Microsoft.Win32.TaskScheduler.dll or in the GAC. public bool ShowEditor() { try { Type t = System.Reflection.ReflectionHelper.LoadType("Microsoft.Win32.TaskScheduler.TaskEditDialog", "Microsoft.Win32.TaskSchedulerEditor.dll"); if (t != null) return System.Reflection.ReflectionHelper.InvokeMethod(t, new object[] { this, true, true }, "ShowDialog") == 1; } catch { } return false; } /// /// Shows the property page for the task (v1.0 only). /// public void ShowPropertyPage() { if (v1Task != null) v1Task.EditWorkItem(IntPtr.Zero, 0); else throw new NotV2SupportedException(); } /// /// Stops the registered task immediately. /// /// /// The Stop method stops all instances of the task. /// System account users can stop a task, users with Administrator group privileges can stop a task, and if a user has rights to execute and read a task, then the user can stop the task. A user can stop the task instances that are running under the same credentials as the user account. In all other cases, the user is denied access to stop the task. /// public void Stop() { if (v2Task != null) v2Task.Stop(0); else v1Task.Terminate(); } /// /// Returns a that represents this instance. /// /// /// A that represents this instance. /// public override string ToString() { return this.Name; } internal void V1Reactivate() { V1Interop.ITask iTask = TaskService.GetTask(this.TaskService.v1TaskScheduler, GetV1Path(v1Task)); if (iTask != null) v1Task = iTask; } internal static Task CreateTask(TaskService svc, TaskScheduler.V2Interop.IRegisteredTask iTask, bool throwError = false) { var iDef = GetV2Definition(svc, iTask, throwError); if (iDef == null && svc.AllowReadOnlyTasks) { iDef = GetV2StrippedDefinition(svc, iTask); return new Task(svc, iTask, iDef) { ReadOnly = true }; } return new Task(svc, iTask, iDef); } internal static int GetOSLibraryMinorVersion() { if (Environment.OSVersion.Version.Major == 6) { switch (Environment.OSVersion.Version.Minor) { case 0: return 2; case 1: return 3; default: return 4; } } return 1; } internal static string GetV1Path(V1Interop.ITask v1Task) { string fileName = string.Empty; try { IPersistFile iFile = (IPersistFile)v1Task; iFile.GetCurFile(out fileName); } catch (Exception ex) { throw ex; } return fileName; } /// /// Gets the ITaskDefinition for a V2 task and prevents the errors that come when connecting remotely to a higher version of the Task Scheduler. /// /// The local task service. /// The task instance. /// if set to true this method will throw an exception if unable to get the task definition. /// /// A valid ITaskDefinition that should not throw errors on the local instance. /// /// Unable to get a compatible task definition for this version of the library. internal static TaskScheduler.V2Interop.ITaskDefinition GetV2Definition(TaskService svc, TaskScheduler.V2Interop.IRegisteredTask iTask, bool throwError = false) { DefDoc dd = new DefDoc(iTask.Xml); Version xmlVer = dd.Version; try { if (xmlVer.Minor > osLibMinorVer) { int newMinor = xmlVer.Minor; if (!dd.Contains("Volatile", "false", true) && !dd.Contains("MaintenanceSettings")) newMinor = 3; if (!dd.Contains("UseUnifiedSchedulingEngine", "false", true) && !dd.Contains("DisallowStartOnRemoteAppSession", "false", true) && !dd.Contains("RequiredPrivileges") && !dd.Contains("ProcessTokenSidType", "Default", true)) newMinor = 2; if (!dd.Contains("DisplayName") && !dd.Contains("GroupId") && !dd.Contains("RunLevel", "LeastPrivilege", true) && !dd.Contains("SecurityDescriptor") && !dd.Contains("Source") && !dd.Contains("URI") && !dd.Contains("AllowStartOnDemand", "true", true) && !dd.Contains("AllowHardTerminate", "true", true) && !dd.Contains("MultipleInstancesPolicy", "IgnoreNew", true) && !dd.Contains("NetworkSettings") && !dd.Contains("StartWhenAvailable", "false", true) && !dd.Contains("SendEmail") && !dd.Contains("ShowMessage") && !dd.Contains("ComHandler") && !dd.Contains("EventTrigger") && !dd.Contains("SessionStateChangeTrigger") && !dd.Contains("RegistrationTrigger") && !dd.Contains("RestartOnFailure") && !dd.Contains("LogonType", "None", true)) newMinor = 1; if (newMinor > osLibMinorVer && throwError) throw new InvalidOperationException(string.Format("The current version of the native library (1.{0}) does not support the original or minimum version of the \"{1}\" task ({2}/1.{3})", osLibMinorVer, iTask.Name, xmlVer, newMinor)); if (newMinor != xmlVer.Minor) { dd.Version = new Version(1, newMinor); TaskScheduler.V2Interop.ITaskDefinition def = svc.v2TaskService.NewTask(0); def.XmlText = dd.Xml; return def; } } return iTask.Definition; } catch (COMException comEx) { if (throwError) { if ((uint)comEx.ErrorCode == 0x80041318 && xmlVer.Minor != osLibMinorVer) // Incorrect XML value throw new InvalidOperationException(string.Format("The current version of the native library (1.{0}) does not support the version of the \"{1}\" task ({2})", osLibMinorVer, iTask.Name, xmlVer)); throw; } } catch { if (throwError) throw; } return null; } internal static TaskScheduler.V2Interop.ITaskDefinition GetV2StrippedDefinition(TaskService svc, TaskScheduler.V2Interop.IRegisteredTask iTask) { DefDoc dd = new DefDoc(iTask.Xml); Version xmlVer = dd.Version; if (xmlVer.Minor > osLibMinorVer) { if (osLibMinorVer < 4) { dd.RemoveTag("Volatile"); dd.RemoveTag("MaintenanceSettings"); } if (osLibMinorVer < 3) { dd.RemoveTag("UseUnifiedSchedulingEngine"); dd.RemoveTag("DisallowStartOnRemoteAppSession"); dd.RemoveTag("RequiredPrivileges"); dd.RemoveTag("ProcessTokenSidType"); } if (osLibMinorVer < 2) { dd.RemoveTag("DisplayName"); dd.RemoveTag("GroupId"); dd.RemoveTag("RunLevel"); dd.RemoveTag("SecurityDescriptor"); dd.RemoveTag("Source"); dd.RemoveTag("URI"); dd.RemoveTag("AllowStartOnDemand"); dd.RemoveTag("AllowHardTerminate"); dd.RemoveTag("MultipleInstancesPolicy"); dd.RemoveTag("NetworkSettings"); dd.RemoveTag("StartWhenAvailable"); dd.RemoveTag("SendEmail"); dd.RemoveTag("ShowMessage"); dd.RemoveTag("ComHandler"); dd.RemoveTag("EventTrigger"); dd.RemoveTag("SessionStateChangeTrigger"); dd.RemoveTag("RegistrationTrigger"); dd.RemoveTag("RestartOnFailure"); dd.RemoveTag("LogonType"); } dd.Version = new Version(1, osLibMinorVer); TaskScheduler.V2Interop.ITaskDefinition def = svc.v2TaskService.NewTask(0); #if DEBUG string path = System.IO.Path.Combine(System.IO.Path.GetTempPath(), string.Format("TS_Stripped_Def_{0}-{1}_{2}.xml", xmlVer.Minor, osLibMinorVer, iTask.Name)); System.IO.File.WriteAllText(path, dd.Xml, System.Text.Encoding.Unicode); #endif def.XmlText = dd.Xml; return def; } return iTask.Definition; } internal static TimeSpan StringToTimeSpan(string input) { if (!string.IsNullOrEmpty(input)) try { return System.Xml.XmlConvert.ToTimeSpan(input); } catch { } return TimeSpan.Zero; } internal static string TimeSpanToString(TimeSpan span) { if (span != TimeSpan.Zero) try { return System.Xml.XmlConvert.ToString(span); } catch { } return null; } private class DefDoc { System.Xml.XmlDocument doc; public DefDoc(string xml) { doc = new XmlDocument(); doc.LoadXml(xml); } public Version Version { get { try { return new Version(doc["Task"].Attributes["version"].Value); } catch { throw new InvalidOperationException("Task definition does not contain a version."); } } set { doc["Task"].Attributes["version"].Value = value.ToString(2); } } public string Xml { get { return doc.OuterXml; } } public bool Contains(string tag, string defaultVal = null, bool removeIfFound = false) { var elems = doc.GetElementsByTagName(tag); if (elems != null && elems.Count > 0) { var e = elems[0]; if (e.InnerText == defaultVal && removeIfFound) { e.ParentNode.RemoveChild(e); return false; } return true; } return false; } public void RemoveTag(string tag) { var elems = doc.GetElementsByTagName(tag); if (elems != null && elems.Count > 0) { var e = elems[0]; e.ParentNode.RemoveChild(e); } } } } /// /// Contains information about the compatibility of the current configuration with a specified version. /// public class TaskCompatibilityEntry { internal TaskCompatibilityEntry(TaskCompatibility comp, string prop, string reason) { this.CompatibilityLevel = comp; this.Property = prop; this.Reason = reason; } /// /// Gets the compatibility level. /// /// /// The compatibility level. /// public TaskCompatibility CompatibilityLevel { get; private set; } /// /// Gets the property name with the incompatibility. /// /// /// The property name. /// public string Property { get; private set; } /// /// Gets the reason for the imcompatibility. /// /// /// The reason. /// public string Reason { get; private set; } } /// /// Defines all the components of a task, such as the task settings, triggers, actions, and registration information. /// [XmlRootAttribute("Task", Namespace = TaskDefinition.tns, IsNullable = false)] [XmlSchemaProvider("GetV1SchemaFile")] public sealed class TaskDefinition : IDisposable, IXmlSerializable { internal const string tns = "http://schemas.microsoft.com/windows/2004/02/mit/task"; internal string v1Name = string.Empty; internal V1Interop.ITask v1Task = null; internal V2Interop.ITaskDefinition v2Def = null; private ActionCollection actions = null; private TaskPrincipal principal = null; private TaskRegistrationInfo regInfo = null; private TaskSettings settings = null; private TriggerCollection triggers = null; internal TaskDefinition(V1Interop.ITask iTask, string name) { v1Task = iTask; v1Name = name; } internal TaskDefinition(V2Interop.ITaskDefinition iDef) { v2Def = iDef; } /// /// Gets a collection of actions that are performed by the task. /// [XmlArrayItem(ElementName = "Exec", IsNullable = true, Type = typeof(ExecAction))] [XmlArray] public ActionCollection Actions { get { if (actions == null) { if (v2Def != null) actions = new ActionCollection(v2Def); else actions = new ActionCollection(v1Task); } return actions; } } /// /// Gets or sets the data that is associated with the task. This data is ignored by the Task Scheduler service, but is used by third-parties who wish to extend the task format. /// public string Data { get { if (v2Def != null) return v2Def.Data; return TaskRegistrationInfo.GetTaskData(v1Task).ToString(); } set { if (v2Def != null) v2Def.Data = value; else TaskRegistrationInfo.SetTaskData(v1Task, value); } } /// /// Gets the lowest supported version that supports the settings for this . /// [XmlIgnore] public TaskCompatibility LowestSupportedVersion { get { return GetLowestSupportedVersion(null); } } /// /// Gets the principal for the task that provides the security credentials for the task. /// public TaskPrincipal Principal { get { if (principal == null) { if (v2Def != null) principal = new TaskPrincipal(v2Def.Principal); else principal = new TaskPrincipal(v1Task); } return principal; } } /// /// Gets a class instance of registration information that is used to describe a task, such as the description of the task, the author of the task, and the date the task is registered. /// public TaskRegistrationInfo RegistrationInfo { get { if (regInfo == null) { if (v2Def != null) regInfo = new TaskRegistrationInfo(v2Def.RegistrationInfo); else regInfo = new TaskRegistrationInfo(v1Task); } return regInfo; } } /// /// Gets the settings that define how the Task Scheduler service performs the task. /// public TaskSettings Settings { get { if (settings == null) { if (v2Def != null) settings = new TaskSettings(v2Def.Settings); else settings = new TaskSettings(v1Task); } return settings; } } /// /// Gets a collection of triggers that are used to start a task. /// [XmlArrayItem(ElementName = "BootTrigger", IsNullable = true, Type = typeof(BootTrigger))] [XmlArrayItem(ElementName = "CalendarTrigger", IsNullable = true, Type = typeof(CalendarTrigger))] [XmlArrayItem(ElementName = "IdleTrigger", IsNullable = true, Type = typeof(IdleTrigger))] [XmlArrayItem(ElementName = "LogonTrigger", IsNullable = true, Type = typeof(LogonTrigger))] [XmlArrayItem(ElementName = "TimeTrigger", IsNullable = true, Type = typeof(TimeTrigger))] [XmlArray] public TriggerCollection Triggers { get { if (triggers == null) { if (v2Def != null) triggers = new TriggerCollection(v2Def); else triggers = new TriggerCollection(v1Task); } return triggers; } } /// /// Gets or sets the XML-formatted definition of the task. /// [XmlIgnore] public string XmlText { get { if (v2Def != null) return v2Def.XmlText; return XmlSerializationHelper.WriteObjectToXmlText(this); } set { if (v2Def != null) v2Def.XmlText = value; else XmlSerializationHelper.ReadObjectFromXmlText(value, this); } } /// /// Determines whether this can use the Unified Scheduling Engine or if it contains unsupported properties. /// /// if set to true throws an with details about unsupported properties in the Data property of the exception. /// true if this this can use the Unified Scheduling Engine; otherwise, false. public bool CanUseUnifiedSchedulingEngine(bool throwExceptionWithDetails = false) { InvalidOperationException ex = new InvalidOperationException() { HelpLink = "http://msdn.microsoft.com/en-us/library/windows/desktop/aa384138(v=vs.85).aspx" }; bool bad = false; if (this.Principal.LogonType == TaskLogonType.InteractiveTokenOrPassword) { bad = true; if (!throwExceptionWithDetails) return false; TryAdd(ex.Data, "Principal.LogonType", "== TaskLogonType.InteractiveTokenOrPassword"); } if (this.Settings.MultipleInstances == TaskInstancesPolicy.StopExisting) { bad = true; if (!throwExceptionWithDetails) return false; TryAdd(ex.Data, "Settings.MultipleInstances", "== TaskInstancesPolicy.StopExisting"); } if (this.Settings.NetworkSettings.Id != Guid.Empty) { bad = true; if (!throwExceptionWithDetails) return false; TryAdd(ex.Data, "Settings.NetworkSettings.Id", "!= Guid.Empty"); } if (!this.Settings.AllowHardTerminate) { bad = true; if (!throwExceptionWithDetails) return false; TryAdd(ex.Data, "Settings.AllowHardTerminate", "== false"); } for (int i = 0; i < this.Actions.Count; i++) { Action a = this.Actions[i]; if (a is EmailAction) { bad = true; if (!throwExceptionWithDetails) return false; TryAdd(ex.Data, string.Format("Actions[{0}]", i), "== typeof(EmailAction)"); } else if (a is ShowMessageAction) { bad = true; if (!throwExceptionWithDetails) return false; TryAdd(ex.Data, string.Format("Actions[{0}]", i), "== typeof(ShowMessageAction)"); } } for (int i = 0; i < this.Triggers.Count; i++) { Trigger t = this.Triggers[i]; if (t is MonthlyTrigger) { bad = true; if (!throwExceptionWithDetails) return false; TryAdd(ex.Data, string.Format("Triggers[{0}]", i), "== typeof(MonthlyTrigger)"); } if (t is MonthlyDOWTrigger) { bad = true; if (!throwExceptionWithDetails) return false; TryAdd(ex.Data, string.Format("Triggers[{0}]", i), "== typeof(MonthlyDOWTrigger)"); } if (t.ExecutionTimeLimit != TimeSpan.Zero) { bad = true; if (!throwExceptionWithDetails) return false; TryAdd(ex.Data, string.Format("Triggers[{0}].ExecutionTimeLimit", i), "!= TimeSpan.Zero"); } if (t is ICalendarTrigger && t.Repetition.IsSet()) { bad = true; if (!throwExceptionWithDetails) return false; TryAdd(ex.Data, string.Format("Triggers[{0}].Repetition", i), ""); } if (t is EventTrigger && ((EventTrigger)t).ValueQueries.Count > 0) { bad = true; if (!throwExceptionWithDetails) return false; TryAdd(ex.Data, string.Format("Triggers[{0}].ValueQueries.Count", i), "!= 0"); } } if (throwExceptionWithDetails) throw ex; return !bad; } /// /// Releases all resources used by this class. /// public void Dispose() { regInfo = null; triggers = null; settings = null; principal = null; actions = null; if (v2Def != null) Marshal.ReleaseComObject(v2Def); v1Task = null; } /// /// Gets the Xml Schema file for V1 tasks. /// /// The for V1 tasks. /// An object containing the Xml Schema for V1 tasks. public static XmlSchemaComplexType GetV1SchemaFile(XmlSchemaSet xs) { XmlSchema schema = null; using (System.IO.Stream xsdFile = System.Reflection.Assembly.GetAssembly(typeof(TaskDefinition)).GetManifestResourceStream("Microsoft.Win32.TaskScheduler.V1.TaskSchedulerV1Schema.xsd")) { XmlSerializer schemaSerializer = new XmlSerializer(typeof(XmlSchema)); schema = (XmlSchema)schemaSerializer.Deserialize(System.Xml.XmlReader.Create(xsdFile)); xs.Add(schema); } // target namespace XmlQualifiedName name = new XmlQualifiedName("taskType", tns); XmlSchemaComplexType productType = (XmlSchemaComplexType)schema.SchemaTypes[name]; return productType; } /// /// Validates the current . /// /// if set to true throw a with details about invalid properties. /// true if current is valid; false if not. public bool Validate(bool throwException = false) { InvalidOperationException ex = new InvalidOperationException(); if (this.Settings.UseUnifiedSchedulingEngine) try { CanUseUnifiedSchedulingEngine(throwException); } catch (InvalidOperationException iox) { foreach (System.Collections.DictionaryEntry kvp in iox.Data) TryAdd(ex.Data, (kvp.Key is ICloneable) ? ((ICloneable)(kvp.Key)).Clone() : kvp.Key, (kvp.Value is ICloneable) ? ((ICloneable)(kvp.Value)).Clone() : kvp.Value); } var list = new System.Collections.Generic.List(); if (GetLowestSupportedVersion(list) > this.Settings.Compatibility) foreach (var item in list) TryAdd(ex.Data, item.Property, item.Reason); if (this.Settings.StartWhenAvailable) { foreach (var trigger in this.Triggers) { //if (!(trigger is ICalendarTrigger)) // TryAdd(ex.Data, "Settings.StartWhenAvailable", "== true requires time-based triggers."); //else { if (trigger.Repetition.Duration != TimeSpan.Zero && trigger.EndBoundary == DateTime.MaxValue) TryAdd(ex.Data, "Settings.StartWhenAvailable", "== true requires time-based tasks with an end boundary or time-based tasks that are set to repeat infinitely."); } } } if (this.Settings.Compatibility < TaskCompatibility.V2) { foreach (var trigger in this.Triggers) { if (trigger.Repetition.Interval != TimeSpan.Zero && trigger.Repetition.Interval >= trigger.Repetition.Duration) TryAdd(ex.Data, "Trigger.Repetition.Interval", ">= Trigger.Repetition.Duration under Task Scheduler 1.0."); } } if (throwException && ex.Data.Count > 0) throw ex; return ex.Data.Count == 0; } static void TryAdd(System.Collections.IDictionary d, object k, object v) { if (!d.Contains(k)) d.Add(k, v); } internal void V1Save(string newName) { if (v1Task != null) { this.Triggers.Bind(); IPersistFile iFile = (IPersistFile)v1Task; if (string.IsNullOrEmpty(newName) || newName == v1Name) { try { iFile.Save(null, false); iFile = null; return; } catch { } } string path; iFile.GetCurFile(out path); System.IO.File.Delete(path); path = System.IO.Path.GetDirectoryName(path) + System.IO.Path.DirectorySeparatorChar + newName + System.IO.Path.GetExtension(path); System.IO.File.Delete(path); iFile.Save(path, true); iFile = null; } } /// /// Gets the lowest supported version. /// /// The output list. /// private TaskCompatibility GetLowestSupportedVersion(System.Collections.Generic.IList outputList = null) { TaskCompatibility res = TaskCompatibility.V1; var list = new System.Collections.Generic.List(); if (this.Principal.DisplayName != null) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Principal.DisplayName", "cannot have a value.")); } if (this.Principal.GroupId != null) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Principal.GroupId", "cannot have a value.")); } //this.Principal.Id != null || if ((this.Principal.LogonType == TaskLogonType.Group || this.Principal.LogonType == TaskLogonType.None || this.Principal.LogonType == TaskLogonType.S4U)) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Principal.LogonType", "cannot be Group, None or S4U.")); } if (this.Principal.RunLevel == TaskRunLevel.Highest) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Principal.RunLevel", "cannot be set to Highest.")); } if (this.RegistrationInfo.SecurityDescriptorSddlForm != null) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "RegistrationInfo.SecurityDescriptorSddlForm", "cannot have a value.")); } if (this.RegistrationInfo.Source != null) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "RegistrationInfo.Source", "cannot have a value.")); } if (this.RegistrationInfo.URI != null) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "RegistrationInfo.URI", "cannot have a value.")); } if (this.RegistrationInfo.Version != new Version(1, 0)) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "RegistrationInfo.Version", "cannot be set or equal 1.0.")); } if (this.Settings.AllowDemandStart == false) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Settings.AllowDemandStart", "must be true.")); } if (this.Settings.AllowHardTerminate == false) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Settings.AllowHardTerminate", "must be true.")); } if (this.Settings.MultipleInstances != TaskInstancesPolicy.IgnoreNew) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Settings.MultipleInstances", "must be set to IgnoreNew.")); } if (this.Settings.NetworkSettings.IsSet()) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Settings.NetworkSetting", "cannot have a value.")); } if (this.Settings.RestartCount != 0) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Settings.RestartCount", "must be 0.")); } if (this.Settings.RestartInterval != TimeSpan.Zero) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Settings.RestartInterval", "must be 0 (TimeSpan.Zero).")); } if (this.Settings.StartWhenAvailable == true) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Settings.StartWhenAvailable", "must be false.")); } if (this.Actions.ContainsType(typeof(EmailAction)) || this.Actions.ContainsType(typeof(ShowMessageAction)) || this.Actions.ContainsType(typeof(ComHandlerAction))) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Actions", "may only contain ExecAction types.")); } if (this.Triggers.ContainsType(typeof(EventTrigger)) || this.Triggers.ContainsType(typeof(SessionStateChangeTrigger)) || this.Triggers.ContainsType(typeof(RegistrationTrigger))) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2, "Triggers", "cannot contain EventTrigger, SessionStateChangeTrigger, or RegistrationTrigger types.")); } if (this.Principal.ProcessTokenSidType != TaskProcessTokenSidType.Default) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2_1, "Principal.ProcessTokenSidType", "must be Default.")); } if (this.Principal.RequiredPrivileges.Count > 0) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2_1, "Principal.RequiredPrivileges", "must be empty.")); } if (this.Settings.DisallowStartOnRemoteAppSession == true) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2_1, "Settings.DisallowStartOnRemoteAppSession", "must be false.")); } if (this.Settings.UseUnifiedSchedulingEngine == true) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2_1, "Settings.UseUnifiedSchedulingEngine", "must be false.")); } if (this.Settings.MaintenanceSettings.IsSet()) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2_2, "this.Settings.MaintenanceSettings", "must have no values set.")); } if (this.Settings.Volatile == true) { list.Add(new TaskCompatibilityEntry(TaskCompatibility.V2_2, " this.Settings.Volatile", "must be false.")); } foreach (var item in list) { if (res < item.CompatibilityLevel) res = item.CompatibilityLevel; if (outputList != null) outputList.Add(item); } return res; } System.Xml.Schema.XmlSchema IXmlSerializable.GetSchema() { return null; } void IXmlSerializable.ReadXml(System.Xml.XmlReader reader) { reader.ReadStartElement("Task", tns); XmlSerializationHelper.ReadObjectProperties(reader, this); reader.ReadEndElement(); if (this.Triggers.Count == 0 || this.Actions.Count != 1) throw new XmlException("Invalid XML stream. Task element must include a Triggers and an Actions element to form a valid task."); } void IXmlSerializable.WriteXml(System.Xml.XmlWriter writer) { XmlSerializationHelper.WriteObjectProperties(writer, this); } } /// /// Provides the security credentials for a principal. These security credentials define the security context for the tasks that are associated with the principal. /// [XmlRoot("Principals", Namespace = TaskDefinition.tns, IsNullable = true)] public sealed class TaskPrincipal : IDisposable, IXmlSerializable { private const string localSystemAcct = "SYSTEM"; private V1Interop.ITask v1Task = null; private V2Interop.IPrincipal v2Principal; private V2Interop.IPrincipal2 v2Principal2; private TaskPrincipalPrivileges reqPriv; internal TaskPrincipal(V2Interop.IPrincipal iPrincipal) { v2Principal = iPrincipal; try { v2Principal2 = (V2Interop.IPrincipal2)v2Principal; } catch { } } internal TaskPrincipal(TaskScheduler.V1Interop.ITask iTask) { v1Task = iTask; } /// /// Gets or sets the name of the principal that is displayed in the Task Scheduler UI. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(null)] [XmlIgnore] public string DisplayName { get { if (v2Principal != null) return v2Principal.DisplayName; return null; } set { if (v2Principal != null) v2Principal.DisplayName = value; else throw new NotV1SupportedException(); } } /// /// Gets or sets the identifier of the user group that is required to run the tasks that are associated with the principal. Setting this property to something other than a null or empty string, will set the property to NULL and will set the property to TaskLogonType.Group; /// /// Not supported under Task Scheduler 1.0. [DefaultValue(null)] [XmlIgnore] public string GroupId { get { if (v2Principal != null) return v2Principal.GroupId; return null; } set { if (v2Principal != null) { if (string.IsNullOrEmpty(value)) value = null; else { v2Principal.UserId = null; v2Principal.LogonType = TaskLogonType.Group; } v2Principal.GroupId = value; } else throw new NotV1SupportedException(); } } /// /// Gets or sets the identifier of the principal. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(null)] [XmlAttribute(AttributeName = "id", DataType = "ID")] [XmlIgnore] public string Id { get { if (v2Principal != null) return v2Principal.Id; return Properties.Resources.TaskDefaultPrincipal; } set { if (v2Principal != null) v2Principal.Id = value; else throw new NotV1SupportedException(); } } /// /// Gets or sets the security logon method that is required to run the tasks that are associated with the principal. /// /// TaskLogonType values of Group, None, or S4UNot are not supported under Task Scheduler 1.0. [DefaultValue(typeof(TaskLogonType), "None")] public TaskLogonType LogonType { get { if (v2Principal != null) return v2Principal.LogonType; if (this.UserId == localSystemAcct) return TaskLogonType.ServiceAccount; if ((v1Task.GetFlags() & V1Interop.TaskFlags.RunOnlyIfLoggedOn) == V1Interop.TaskFlags.RunOnlyIfLoggedOn) return TaskLogonType.InteractiveToken; return TaskLogonType.InteractiveTokenOrPassword; } set { if (v2Principal != null) v2Principal.LogonType = value; else { if (value == TaskLogonType.Group || value == TaskLogonType.None || value == TaskLogonType.S4U) throw new NotV1SupportedException(); V1Interop.TaskFlags flags = v1Task.GetFlags(); if (value == TaskLogonType.InteractiveToken) flags |= V1Interop.TaskFlags.RunOnlyIfLoggedOn; else flags &= ~(V1Interop.TaskFlags.RunOnlyIfLoggedOn); v1Task.SetFlags(flags); } } } /// /// Gets or sets the task process security identifier (SID) type. /// /// /// One of the enumeration constants. /// /// Setting this value appears to break the Task Scheduler MMC and does not output in XML. Removed to prevent problems. /// Not supported under Task Scheduler versions prior to 2.1. [XmlIgnore, DefaultValue(typeof(TaskProcessTokenSidType), "Default")] public TaskProcessTokenSidType ProcessTokenSidType { get { if (v2Principal2 != null) return v2Principal2.ProcessTokenSidType; return TaskProcessTokenSidType.Default; } set { if (v2Principal2 != null) v2Principal2.ProcessTokenSidType = value; else throw new NotSupportedPriorToException(TaskCompatibility.V2_1); } } /// /// Gets the security credentials for a principal. These security credentials define the security context for the tasks that are associated with the principal. /// /// Setting this value appears to break the Task Scheduler MMC and does not output in XML. Removed to prevent problems. [XmlIgnore] public TaskPrincipalPrivileges RequiredPrivileges { get { if (reqPriv == null) reqPriv = new TaskPrincipalPrivileges(this.v2Principal2); return reqPriv; } } /// /// Gets or sets the identifier that is used to specify the privilege level that is required to run the tasks that are associated with the principal. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(typeof(TaskRunLevel), "LUA")] [XmlIgnore] public TaskRunLevel RunLevel { get { if (v2Principal != null) return v2Principal.RunLevel; return TaskRunLevel.LUA; } set { if (v2Principal != null) v2Principal.RunLevel = value; else throw new NotV1SupportedException(); } } /// /// Gets or sets the user identifier that is required to run the tasks that are associated with the principal. Setting this property to something other than a null or empty string, will set the property to NULL; /// [DefaultValue("")] public string UserId { get { if (v2Principal != null) return v2Principal.UserId; try { string acct = v1Task.GetAccountInformation(); return string.IsNullOrEmpty(acct) ? localSystemAcct : acct; } catch { return null; } } set { if (v2Principal != null) { if (string.IsNullOrEmpty(value)) value = null; else { v2Principal.GroupId = null; //if (value.Contains(@"\") && !value.Contains(@"\\")) // value = value.Replace(@"\", @"\\"); } v2Principal.UserId = value; } else { if (value.Equals(localSystemAcct, StringComparison.CurrentCultureIgnoreCase)) value = ""; v1Task.SetAccountInformation(value, IntPtr.Zero); } } } /// /// Releases all resources used by this class. /// public void Dispose() { if (v2Principal != null) Marshal.ReleaseComObject(v2Principal); v1Task = null; } /// /// Returns a that represents this instance. /// /// /// A that represents this instance. /// public override string ToString() { return this.LogonType == TaskLogonType.Group ? this.GroupId : this.UserId; } /// /// Validates the supplied account against the supplied . /// /// The user or group account name. /// The SID type for the process. /// true if supplied account can be used for the supplied SID type. public static bool ValidateAccountForSidType(string acct, TaskProcessTokenSidType sidType) { string[] validUserIds = new string[] { "NETWORK SERVICE", "LOCAL SERVICE", "S-1-5-19", "S-1-5-20" }; if (sidType != TaskProcessTokenSidType.Default) { if (Array.Find(validUserIds, delegate(string id) { return id.Equals(acct, StringComparison.InvariantCultureIgnoreCase); }) == null) return false; } return true; } XmlSchema IXmlSerializable.GetSchema() { return null; } void IXmlSerializable.ReadXml(XmlReader reader) { reader.ReadStartElement("Principals", TaskDefinition.tns); reader.Read(); while (reader.MoveToContent() == XmlNodeType.Element) { switch (reader.LocalName) { case "Principal": reader.Read(); XmlSerializationHelper.ReadObjectProperties(reader, this); reader.ReadEndElement(); break; default: reader.Skip(); break; } } reader.ReadEndElement(); } void IXmlSerializable.WriteXml(XmlWriter writer) { if (!string.IsNullOrEmpty(this.ToString()) || this.LogonType != TaskLogonType.None) { writer.WriteStartElement("Principal"); XmlSerializationHelper.WriteObjectProperties(writer, this); writer.WriteEndElement(); } } } /// /// List of security credentials for a principal under version 1.3 of the Task Scheduler. These security credentials define the security context for the tasks that are associated with the principal. /// public sealed class TaskPrincipalPrivileges : System.Collections.Generic.IList { private V2Interop.IPrincipal2 v2Principal2; internal TaskPrincipalPrivileges(V2Interop.IPrincipal2 iPrincipal2 = null) { this.v2Principal2 = iPrincipal2; } /// /// Determines the index of a specific item in the . /// /// The object to locate in the . /// /// The index of if found in the list; otherwise, -1. /// public int IndexOf(TaskPrincipalPrivilege item) { for (int i = 0; i < this.Count; i++) { if (item == this[i]) return i; } return -1; } /// /// Inserts an item to the at the specified index. /// /// The zero-based index at which should be inserted. /// The object to insert into the . /// is not a valid index in the . /// /// /// /// The is read-only. /// public void Insert(int index, TaskPrincipalPrivilege item) { throw new NotImplementedException(); } /// /// Removes the item at the specified index. /// /// The zero-based index of the item to remove. /// is not a valid index in the . /// /// /// /// The is read-only. /// public void RemoveAt(int index) { throw new NotImplementedException(); } /// /// Gets or sets the element at the specified index. /// /// /// The element at the specified index. /// /// /// is not a valid index in the . /// /// /// /// The property is set and the is read-only. /// public TaskPrincipalPrivilege this[int index] { get { if (this.v2Principal2 != null) return (TaskPrincipalPrivilege)Enum.Parse(typeof(TaskPrincipalPrivilege), v2Principal2[index + 1]); throw new IndexOutOfRangeException(); } set { throw new NotImplementedException(); } } /// /// Adds an item to the . /// /// The object to add to the . /// /// The is read-only. /// public void Add(TaskPrincipalPrivilege item) { if (this.v2Principal2 != null) this.v2Principal2.AddRequiredPrivilege(item.ToString()); else throw new NotSupportedPriorToException(TaskCompatibility.V2_1); } /// /// Removes all items from the . /// /// /// The is read-only. /// public void Clear() { throw new NotImplementedException(); } /// /// Determines whether the contains a specific value. /// /// The object to locate in the . /// /// true if is found in the ; otherwise, false. /// public bool Contains(TaskPrincipalPrivilege item) { return (this.IndexOf(item) != -1); } /// /// Copies to. /// /// The array. /// Index of the array. public void CopyTo(TaskPrincipalPrivilege[] array, int arrayIndex) { var pEnum = GetEnumerator(); for (int i = arrayIndex; i < array.Length; i++) { if (!pEnum.MoveNext()) break; array[i] = pEnum.Current; } } /// /// Gets the number of elements contained in the . /// /// /// The number of elements contained in the . /// public int Count { get { return (this.v2Principal2 != null) ? (int)this.v2Principal2.RequiredPrivilegeCount : 0; } } /// /// Gets a value indicating whether the is read-only. /// /// true if the is read-only; otherwise, false. /// public bool IsReadOnly { get { return false; } } /// /// Removes the first occurrence of a specific object from the . /// /// The object to remove from the . /// /// true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . /// /// /// The is read-only. /// public bool Remove(TaskPrincipalPrivilege item) { throw new NotImplementedException(); } /// /// Returns an enumerator that iterates through the collection. /// /// /// A that can be used to iterate through the collection. /// public System.Collections.Generic.IEnumerator GetEnumerator() { return new TaskPrincipalPrivilegesEnumerator(this.v2Principal2); } System.Collections.IEnumerator System.Collections.IEnumerable.GetEnumerator() { return GetEnumerator(); } /// /// Enumerates the privileges set for a principal under version 1.3 of the Task Scheduler. /// public sealed class TaskPrincipalPrivilegesEnumerator : System.Collections.Generic.IEnumerator { private V2Interop.IPrincipal2 v2Principal2; int cur; TaskPrincipalPrivilege curVal; internal TaskPrincipalPrivilegesEnumerator(V2Interop.IPrincipal2 iPrincipal2 = null) { this.v2Principal2 = iPrincipal2; Reset(); } /// /// Gets the element in the collection at the current position of the enumerator. /// /// /// The element in the collection at the current position of the enumerator. /// public TaskPrincipalPrivilege Current { get { return curVal; } } /// /// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. /// public void Dispose() { } object System.Collections.IEnumerator.Current { get { return this.Current; } } /// /// Advances the enumerator to the next element of the collection. /// /// /// true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. /// /// /// The collection was modified after the enumerator was created. /// public bool MoveNext() { if (this.v2Principal2 != null && cur < v2Principal2.RequiredPrivilegeCount) { cur++; curVal = (TaskPrincipalPrivilege)Enum.Parse(typeof(TaskPrincipalPrivilege), v2Principal2[cur]); return true; } curVal = 0; return false; } /// /// Sets the enumerator to its initial position, which is before the first element in the collection. /// /// /// The collection was modified after the enumerator was created. /// public void Reset() { cur = 0; curVal = 0; } } } /// /// Provides the administrative information that can be used to describe the task. This information includes details such as a description of the task, the author of the task, the date the task is registered, and the security descriptor of the task. /// [XmlRoot("RegistrationInfo", Namespace = TaskDefinition.tns, IsNullable = true)] public sealed class TaskRegistrationInfo : IDisposable, IXmlSerializable { private TaskScheduler.V1Interop.ITask v1Task = null; private TaskScheduler.V2Interop.IRegistrationInfo v2RegInfo = null; internal TaskRegistrationInfo(TaskScheduler.V2Interop.IRegistrationInfo iRegInfo) { v2RegInfo = iRegInfo; } internal TaskRegistrationInfo(TaskScheduler.V1Interop.ITask iTask) { v1Task = iTask; } /// /// Gets or sets the author of the task. /// [DefaultValue(null)] public string Author { get { if (v2RegInfo != null) return v2RegInfo.Author; return v1Task.GetCreator(); } set { if (v2RegInfo != null) v2RegInfo.Author = value; else v1Task.SetCreator(value); } } /// /// Gets or sets the date and time when the task is registered. /// /// This property cannot be set on an unregistered task under Task Scheduler 1.0. [DefaultValue(typeof(DateTime), "0001-01-01T00:00:00")] [XmlIgnore] public DateTime Date { get { if (v2RegInfo != null) { string d = v2RegInfo.Date; return string.IsNullOrEmpty(d) ? DateTime.MinValue : DateTime.Parse(d, Trigger.DefaultDateCulture); } string v1Path = Task.GetV1Path(v1Task); if (!string.IsNullOrEmpty(v1Path) && System.IO.File.Exists(v1Path)) return System.IO.File.GetLastWriteTime(v1Path); return DateTime.MinValue; } set { if (v2RegInfo != null) v2RegInfo.Date = value == null ? null : value.ToString(Trigger.V2BoundaryDateFormat, Trigger.DefaultDateCulture); else { string v1Path = Task.GetV1Path(v1Task); if (!string.IsNullOrEmpty(v1Path) && System.IO.File.Exists(v1Path)) System.IO.File.SetLastWriteTime(v1Path, value); else throw new NotV1SupportedException("This property cannot be set on an unregistered task."); } } } /// /// Gets or sets the description of the task. /// [DefaultValue(null)] public string Description { get { if (v2RegInfo != null) return v2RegInfo.Description; return v1Task.GetComment(); } set { if (v2RegInfo != null) v2RegInfo.Description = value; else v1Task.SetComment(value); } } /// /// Gets or sets any additional documentation for the task. /// [DefaultValue(null)] public string Documentation { get { if (v2RegInfo != null) return v2RegInfo.Documentation; return GetTaskData(v1Task).ToString(); } set { if (v2RegInfo != null) v2RegInfo.Documentation = value; else SetTaskData(v1Task, value); } } /// /// Gets or sets the security descriptor of the task. /// /// The security descriptor. [XmlIgnore] public System.Security.AccessControl.GenericSecurityDescriptor SecurityDescriptor { get { return new System.Security.AccessControl.RawSecurityDescriptor(this.SecurityDescriptorSddlForm); } set { this.SecurityDescriptorSddlForm = value == null ? null : value.GetSddlForm(Task.defaultAccessControlSections); } } /// /// Gets or sets the security descriptor of the task. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(null)] [XmlIgnore] public string SecurityDescriptorSddlForm { get { object sddl = null; if (v2RegInfo != null) sddl = v2RegInfo.SecurityDescriptor; return sddl == null ? null : sddl.ToString(); } set { if (v2RegInfo != null) v2RegInfo.SecurityDescriptor = value; else throw new NotV1SupportedException(); } } /// /// Gets or sets where the task originated from. For example, a task may originate from a component, service, application, or user. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(null)] [XmlIgnore] public string Source { get { if (v2RegInfo != null) return v2RegInfo.Source; return null; } set { if (v2RegInfo != null) v2RegInfo.Source = value; else throw new NotV1SupportedException(); } } /// /// Gets or sets the URI of the task. /// /// Not supported under Task Scheduler 1.0. /// Note: Breaking change in version 2.0. This property was previously of type . It was found that in Windows 8, /// many of the native tasks use this property in a string format rather than in a URI format. [DefaultValue(null)] [XmlIgnore] public String URI { get { string uri = null; if (v2RegInfo != null) uri = v2RegInfo.URI; if (string.IsNullOrEmpty(uri)) return null; return uri; } set { if (v2RegInfo != null) v2RegInfo.URI = value; else throw new NotV1SupportedException(); } } /// /// Gets or sets the version number of the task. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(typeof(Version), "1.0")] [XmlIgnore] public Version Version { get { if (v2RegInfo != null && v2RegInfo.Version != null) { try { return new Version(v2RegInfo.Version); } catch { } } return new Version(1, 0); } set { if (v2RegInfo != null) v2RegInfo.Version = value == null ? null : value.ToString(); else throw new NotV1SupportedException(); } } /// /// Gets or sets an XML-formatted version of the registration information for the task. /// [XmlIgnore] public string XmlText { get { if (v2RegInfo != null) return v2RegInfo.XmlText; return XmlSerializationHelper.WriteObjectToXmlText(this); } set { if (v2RegInfo != null) v2RegInfo.XmlText = value; else XmlSerializationHelper.ReadObjectFromXmlText(value, this); } } /// /// Releases all resources used by this class. /// public void Dispose() { v1Task = null; if (v2RegInfo != null) Marshal.ReleaseComObject(v2RegInfo); } /// /// Returns a that represents this instance. /// /// /// A that represents this instance. /// public override string ToString() { if (v2RegInfo != null || v1Task != null) return DebugHelper.GetDebugString(this); return base.ToString(); } internal static object GetTaskData(V1Interop.ITask v1Task) { try { ushort DataLen; byte[] bytes; v1Task.GetWorkItemData(out DataLen, out bytes); System.IO.MemoryStream stream = new System.IO.MemoryStream(bytes, false); System.Runtime.Serialization.Formatters.Binary.BinaryFormatter b = new System.Runtime.Serialization.Formatters.Binary.BinaryFormatter(); return b.Deserialize(stream); } catch { } return string.Empty; } internal static void SetTaskData(V1Interop.ITask v1Task, object value) { if (value == null) v1Task.SetWorkItemData(0, null); else { System.Runtime.Serialization.Formatters.Binary.BinaryFormatter b = new System.Runtime.Serialization.Formatters.Binary.BinaryFormatter(); System.IO.MemoryStream stream = new System.IO.MemoryStream(); b.Serialize(stream, value); v1Task.SetWorkItemData((ushort)stream.Length, stream.ToArray()); } } XmlSchema IXmlSerializable.GetSchema() { return null; } void IXmlSerializable.ReadXml(XmlReader reader) { if (!reader.IsEmptyElement) { reader.ReadStartElement("RegistrationInfo", TaskDefinition.tns); XmlSerializationHelper.ReadObjectProperties(reader, this); reader.ReadEndElement(); } else reader.Skip(); } void IXmlSerializable.WriteXml(XmlWriter writer) { XmlSerializationHelper.WriteObjectProperties(writer, this); } } /// /// Provides the settings that the Task Scheduler service uses to perform the task. /// [XmlRoot("Settings", Namespace = TaskDefinition.tns, IsNullable = true)] public sealed class TaskSettings : IDisposable, IXmlSerializable { private const uint InfiniteRunTimeV1 = 0xFFFFFFFF; private IdleSettings idleSettings = null; private MaintenanceSettings maintenanceSettings = null; private NetworkSettings networkSettings = null; private TaskScheduler.V1Interop.ITask v1Task = null; private TaskScheduler.V2Interop.ITaskSettings v2Settings = null; private TaskScheduler.V2Interop.ITaskSettings2 v2Settings2 = null; private TaskScheduler.V2Interop.ITaskSettings3 v2Settings3 = null; internal TaskSettings(TaskScheduler.V2Interop.ITaskSettings iSettings) { v2Settings = iSettings; try { v2Settings2 = (TaskScheduler.V2Interop.ITaskSettings2)v2Settings; } catch { } try { v2Settings3 = (TaskScheduler.V2Interop.ITaskSettings3)v2Settings; } catch { } } internal TaskSettings(TaskScheduler.V1Interop.ITask iTask) { v1Task = iTask; } /// /// Gets or sets a Boolean value that indicates that the task can be started by using either the Run command or the Context menu. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(true)] [XmlElement("AllowStartOnDemand")] [XmlIgnore] public bool AllowDemandStart { get { if (v2Settings != null) return v2Settings.AllowDemandStart; return true; } set { if (v2Settings != null) v2Settings.AllowDemandStart = value; else throw new NotV1SupportedException(); } } /// /// Gets or sets a Boolean value that indicates that the task may be terminated by using TerminateProcess. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(true)] [XmlIgnore] public bool AllowHardTerminate { get { if (v2Settings != null) return v2Settings.AllowHardTerminate; return true; } set { if (v2Settings != null) v2Settings.AllowHardTerminate = value; else throw new NotV1SupportedException(); } } /// /// Gets or sets an integer value that indicates which version of Task Scheduler a task is compatible with. /// /// Not supported under Task Scheduler 1.0. [XmlIgnore] public TaskCompatibility Compatibility { get { if (v2Settings != null) return v2Settings.Compatibility; return TaskCompatibility.V1; } set { if (v2Settings != null) v2Settings.Compatibility = value; else if (value != TaskCompatibility.V1) throw new NotV1SupportedException(); } } /// /// Gets or sets the amount of time that the Task Scheduler will wait before deleting the task after it expires. If no value is specified for this property, then the Task Scheduler service will not delete the task. /// /// /// Gets and sets the amount of time that the Task Scheduler will wait before deleting the task after it expires. For Task Scheduler 1.0, this property will return a TimeSpan of 1 second if the task is set to delete when done. For either version, TimeSpan.Zero will indicate that the task should not be deleted. /// /// /// A task expires after the end boundary has been exceeded for all triggers associated with the task. The end boundary for a trigger is specified by the EndBoundary property of all trigger types. /// [DefaultValue(typeof(TimeSpan), "12:00:00")] public TimeSpan DeleteExpiredTaskAfter { get { if (v2Settings != null) return Task.StringToTimeSpan(v2Settings.DeleteExpiredTaskAfter); return (v1Task.GetFlags() & V1Interop.TaskFlags.DeleteWhenDone) == V1Interop.TaskFlags.DeleteWhenDone ? TimeSpan.FromSeconds(1) : TimeSpan.Zero; } set { if (v2Settings != null) v2Settings.DeleteExpiredTaskAfter = Task.TimeSpanToString(value); else { V1Interop.TaskFlags flags = v1Task.GetFlags(); if (value >= TimeSpan.FromSeconds(1)) v1Task.SetFlags(flags |= V1Interop.TaskFlags.DeleteWhenDone); else v1Task.SetFlags(flags &= ~V1Interop.TaskFlags.DeleteWhenDone); } } } /// /// Gets or sets a Boolean value that indicates that the task will not be started if the computer is running on battery power. /// [DefaultValue(true)] public bool DisallowStartIfOnBatteries { get { if (v2Settings != null) return v2Settings.DisallowStartIfOnBatteries; return (v1Task.GetFlags() & V1Interop.TaskFlags.DontStartIfOnBatteries) == V1Interop.TaskFlags.DontStartIfOnBatteries; } set { if (v2Settings != null) v2Settings.DisallowStartIfOnBatteries = value; else { V1Interop.TaskFlags flags = v1Task.GetFlags(); if (value) v1Task.SetFlags(flags |= V1Interop.TaskFlags.DontStartIfOnBatteries); else v1Task.SetFlags(flags &= ~V1Interop.TaskFlags.DontStartIfOnBatteries); } } } /// /// Gets or sets a Boolean value that indicates that the task will not be started if the task is triggered to run in a Remote Applications Integrated Locally (RAIL) session. /// /// Property set for a task on a Task Scheduler version prior to 2.1. [DefaultValue(false)] [XmlIgnore] public bool DisallowStartOnRemoteAppSession { get { if (v2Settings2 != null) return v2Settings2.DisallowStartOnRemoteAppSession; if (v2Settings3 != null) return v2Settings3.DisallowStartOnRemoteAppSession; return false; } set { if (v2Settings2 != null) v2Settings2.DisallowStartOnRemoteAppSession = value; else if (v2Settings3 != null) v2Settings3.DisallowStartOnRemoteAppSession = value; else throw new NotSupportedPriorToException(TaskCompatibility.V2_1); } } /// /// Gets or sets a Boolean value that indicates that the task is enabled. The task can be performed only when this setting is TRUE. /// [DefaultValue(true)] public bool Enabled { get { if (v2Settings != null) return v2Settings.Enabled; return (v1Task.GetFlags() & V1Interop.TaskFlags.Disabled) != V1Interop.TaskFlags.Disabled; } set { if (v2Settings != null) v2Settings.Enabled = value; else { V1Interop.TaskFlags flags = v1Task.GetFlags(); if (!value) v1Task.SetFlags(flags |= V1Interop.TaskFlags.Disabled); else v1Task.SetFlags(flags &= ~V1Interop.TaskFlags.Disabled); } } } /// /// Gets or sets the amount of time that is allowed to complete the task. By default, a task will be stopped 72 hours after it starts to run. /// /// /// The amount of time that is allowed to complete the task. When this parameter is set to , the execution time limit is infinite. /// /// /// If a task is started on demand, the ExecutionTimeLimit setting is bypassed. Therefore, a task that is started on demand will not be terminated if it exceeds the ExecutionTimeLimit. /// [DefaultValue(typeof(TimeSpan), "72:00:00")] public TimeSpan ExecutionTimeLimit { get { if (v2Settings != null) return Task.StringToTimeSpan(v2Settings.ExecutionTimeLimit); uint ms = v1Task.GetMaxRunTime(); return ms == InfiniteRunTimeV1 ? TimeSpan.Zero : TimeSpan.FromMilliseconds(ms); } set { if (v2Settings != null) v2Settings.ExecutionTimeLimit = value == TimeSpan.Zero ? "PT0S" : Task.TimeSpanToString(value); else { // Due to a bug introduced in Vista, and propogated to Windows 7, setting the // MaxRunTime to INFINITE results in the task only running for 72 hours. For // these operating systems, setting the RunTime to "INFINITE - 1" gets the // desired behavior of allowing an "infinite" run of the task. uint ms = value == TimeSpan.Zero ? InfiniteRunTimeV1 : Convert.ToUInt32(value.TotalMilliseconds); v1Task.SetMaxRunTime(ms); if (value == TimeSpan.Zero && v1Task.GetMaxRunTime() != InfiniteRunTimeV1) v1Task.SetMaxRunTime(InfiniteRunTimeV1 - 1); } } } /// /// Gets or sets a Boolean value that indicates that the task will not be visible in the UI by default. /// [DefaultValue(false)] public bool Hidden { get { if (v2Settings != null) return v2Settings.Hidden; return (v1Task.GetFlags() & V1Interop.TaskFlags.Hidden) == V1Interop.TaskFlags.Hidden; } set { if (v2Settings != null) v2Settings.Hidden = value; else { V1Interop.TaskFlags flags = v1Task.GetFlags(); if (value) v1Task.SetFlags(flags |= V1Interop.TaskFlags.Hidden); else v1Task.SetFlags(flags &= ~V1Interop.TaskFlags.Hidden); } } } /// /// Gets or sets the information that specifies how the Task Scheduler performs tasks when the computer is in an idle state. /// public IdleSettings IdleSettings { get { if (idleSettings == null) { if (v2Settings != null) idleSettings = new IdleSettings(v2Settings.IdleSettings); else idleSettings = new IdleSettings(v1Task); } return idleSettings; } } /// /// Gets or sets the information that the Task Scheduler uses during Automatic maintenance. /// [XmlIgnore] public MaintenanceSettings MaintenanceSettings { get { if (maintenanceSettings == null) maintenanceSettings = new MaintenanceSettings(v2Settings3); return maintenanceSettings; } } /// /// Gets or sets the policy that defines how the Task Scheduler handles multiple instances of the task. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(typeof(TaskInstancesPolicy), "IgnoreNew")] [XmlIgnore] public TaskInstancesPolicy MultipleInstances { get { if (v2Settings != null) return v2Settings.MultipleInstances; return TaskInstancesPolicy.IgnoreNew; } set { if (v2Settings != null) v2Settings.MultipleInstances = value; else throw new NotV1SupportedException(); } } /// /// Gets or sets the network settings object that contains a network profile identifier and name. If the RunOnlyIfNetworkAvailable property of ITaskSettings is true and a network propfile is specified in the NetworkSettings property, then the task will run only if the specified network profile is available. /// [XmlIgnore] public NetworkSettings NetworkSettings { get { if (networkSettings == null) networkSettings = new NetworkSettings(v2Settings == null ? null : v2Settings.NetworkSettings); return networkSettings; } } /// /// Gets or sets the priority level of the task. /// /// /// The priority. /// /// Value set to AboveNormal or BelowNormal on Task Scheduler 1.0. [DefaultValue(typeof(System.Diagnostics.ProcessPriorityClass), "Normal")] public System.Diagnostics.ProcessPriorityClass Priority { get { if (v2Settings != null) { return GetPriorityFromInt(v2Settings.Priority); } return (System.Diagnostics.ProcessPriorityClass)v1Task.GetPriority(); } set { if (v2Settings != null) { v2Settings.Priority = GetPriorityAsInt(value); } else { if (value == System.Diagnostics.ProcessPriorityClass.AboveNormal || value == System.Diagnostics.ProcessPriorityClass.BelowNormal) throw new NotV1SupportedException("Unsupported priority level on Task Scheduler 1.0."); v1Task.SetPriority((uint)value); } } } private System.Diagnostics.ProcessPriorityClass GetPriorityFromInt(int value) { switch (value) { case 0: return System.Diagnostics.ProcessPriorityClass.RealTime; case 1: return System.Diagnostics.ProcessPriorityClass.High; case 2: case 3: return System.Diagnostics.ProcessPriorityClass.AboveNormal; case 4: case 5: case 6: return System.Diagnostics.ProcessPriorityClass.Normal; case 7: case 8: default: return System.Diagnostics.ProcessPriorityClass.BelowNormal; case 9: case 10: return System.Diagnostics.ProcessPriorityClass.Idle; } } private int GetPriorityAsInt(System.Diagnostics.ProcessPriorityClass value) { int p = 7; switch (value) { case System.Diagnostics.ProcessPriorityClass.AboveNormal: p = 3; break; case System.Diagnostics.ProcessPriorityClass.High: p = 1; break; case System.Diagnostics.ProcessPriorityClass.Idle: p = 10; break; case System.Diagnostics.ProcessPriorityClass.Normal: p = 5; break; case System.Diagnostics.ProcessPriorityClass.RealTime: p = 0; break; case System.Diagnostics.ProcessPriorityClass.BelowNormal: default: break; } return p; } /// /// Gets or sets the number of times that the Task Scheduler will attempt to restart the task. /// /// /// The number of times that the Task Scheduler will attempt to restart the task. If this property is set, the property must also be set. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(0)] [XmlIgnore] public int RestartCount { get { if (v2Settings != null) return v2Settings.RestartCount; return 0; } set { if (v2Settings != null) v2Settings.RestartCount = value; else throw new NotV1SupportedException(); } } /// /// Gets or sets a value that specifies how long the Task Scheduler will attempt to restart the task. /// /// /// A value that specifies how long the Task Scheduler will attempt to restart the task. If this property is set, the property must also be set. The maximum time allowed is 31 days, and the minimum time allowed is 1 minute. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(typeof(TimeSpan), "00:00:00")] [XmlIgnore] public TimeSpan RestartInterval { get { if (v2Settings != null) return Task.StringToTimeSpan(v2Settings.RestartInterval); return TimeSpan.Zero; } set { if (v2Settings != null) v2Settings.RestartInterval = Task.TimeSpanToString(value); else throw new NotV1SupportedException(); } } /// /// Gets or sets a Boolean value that indicates that the Task Scheduler will run the task only if the computer is in an idle condition. /// [DefaultValue(false)] public bool RunOnlyIfIdle { get { if (v2Settings != null) return v2Settings.RunOnlyIfIdle; return (v1Task.GetFlags() & V1Interop.TaskFlags.StartOnlyIfIdle) == V1Interop.TaskFlags.StartOnlyIfIdle; } set { if (v2Settings != null) v2Settings.RunOnlyIfIdle = value; else { V1Interop.TaskFlags flags = v1Task.GetFlags(); if (value) v1Task.SetFlags(flags |= V1Interop.TaskFlags.StartOnlyIfIdle); else v1Task.SetFlags(flags &= ~V1Interop.TaskFlags.StartOnlyIfIdle); } } } /// /// Gets or sets a Boolean value that indicates that the Task Scheduler will run the task only if the user is logged on (v1.0 only) /// /// Property set for a task on a Task Scheduler version other than 1.0. [XmlIgnore] public bool RunOnlyIfLoggedOn { get { if (v2Settings != null) return true; return (v1Task.GetFlags() & V1Interop.TaskFlags.RunOnlyIfLoggedOn) == V1Interop.TaskFlags.RunOnlyIfLoggedOn; } set { if (v1Task != null) { V1Interop.TaskFlags flags = v1Task.GetFlags(); if (value) v1Task.SetFlags(flags |= V1Interop.TaskFlags.RunOnlyIfLoggedOn); else v1Task.SetFlags(flags &= ~V1Interop.TaskFlags.RunOnlyIfLoggedOn); } else if (v2Settings != null) throw new NotV2SupportedException("Task Scheduler 2.0 (1.2) does not support setting this property. You must use an InteractiveToken in order to have the task run in the current user session."); } } /// /// Gets or sets a Boolean value that indicates that the Task Scheduler will run the task only when a network is available. /// [DefaultValue(false)] public bool RunOnlyIfNetworkAvailable { get { if (v2Settings != null) return v2Settings.RunOnlyIfNetworkAvailable; return (v1Task.GetFlags() & V1Interop.TaskFlags.RunIfConnectedToInternet) == V1Interop.TaskFlags.RunIfConnectedToInternet; } set { if (v2Settings != null) v2Settings.RunOnlyIfNetworkAvailable = value; else { V1Interop.TaskFlags flags = v1Task.GetFlags(); if (value) v1Task.SetFlags(flags |= V1Interop.TaskFlags.RunIfConnectedToInternet); else v1Task.SetFlags(flags &= ~V1Interop.TaskFlags.RunIfConnectedToInternet); } } } /// /// Gets or sets a Boolean value that indicates that the Task Scheduler can start the task at any time after its scheduled time has passed. /// /// Not supported under Task Scheduler 1.0. [DefaultValue(false)] [XmlIgnore] public bool StartWhenAvailable { get { if (v2Settings != null) return v2Settings.StartWhenAvailable; return false; } set { if (v2Settings != null) v2Settings.StartWhenAvailable = value; else throw new NotV1SupportedException(); } } /// /// Gets or sets a Boolean value that indicates that the task will be stopped if the computer switches to battery power. /// [DefaultValue(true)] public bool StopIfGoingOnBatteries { get { if (v2Settings != null) return v2Settings.StopIfGoingOnBatteries; return (v1Task.GetFlags() & V1Interop.TaskFlags.KillIfGoingOnBatteries) == V1Interop.TaskFlags.KillIfGoingOnBatteries; } set { if (v2Settings != null) v2Settings.StopIfGoingOnBatteries = value; else { V1Interop.TaskFlags flags = v1Task.GetFlags(); if (value) v1Task.SetFlags(flags |= V1Interop.TaskFlags.KillIfGoingOnBatteries); else v1Task.SetFlags(flags &= ~V1Interop.TaskFlags.KillIfGoingOnBatteries); } } } /// /// Gets or sets a Boolean value that indicates that the Unified Scheduling Engine will be utilized to run this task. /// /// Property set for a task on a Task Scheduler version prior to 2.1. [DefaultValue(false)] [XmlIgnore] public bool UseUnifiedSchedulingEngine { get { if (v2Settings2 != null) return v2Settings2.UseUnifiedSchedulingEngine; if (v2Settings3 != null) return v2Settings3.UseUnifiedSchedulingEngine; return false; } set { if (v2Settings2 != null) v2Settings2.UseUnifiedSchedulingEngine = value; else if (v2Settings3 != null) v2Settings3.UseUnifiedSchedulingEngine = value; else throw new NotSupportedPriorToException(TaskCompatibility.V2_1); } } /// /// Gets or sets a boolean value that indicates whether the task is automatically disabled every time Windows starts. /// /// Property set for a task on a Task Scheduler version prior to 2.2. [DefaultValue(false)] [XmlIgnore] public bool Volatile { get { if (v2Settings3 != null) return v2Settings3.Volatile; return false; } set { if (v2Settings3 != null) v2Settings3.Volatile = value; else throw new NotSupportedPriorToException(TaskCompatibility.V2_2); } } /// /// Gets or sets a Boolean value that indicates that the Task Scheduler will wake the computer when it is time to run the task. /// [DefaultValue(false)] public bool WakeToRun { get { if (v2Settings != null) return v2Settings.WakeToRun; return ((v1Task.GetFlags() & V1Interop.TaskFlags.SystemRequired) == V1Interop.TaskFlags.SystemRequired); } set { if (v2Settings != null) v2Settings.WakeToRun = value; else { V1Interop.TaskFlags flags = v1Task.GetFlags(); if (value) v1Task.SetFlags(flags |= V1Interop.TaskFlags.SystemRequired); else v1Task.SetFlags(flags &= ~V1Interop.TaskFlags.SystemRequired); } } } /// /// Gets or sets an XML-formatted definition of the task settings. /// [XmlIgnore] public string XmlText { get { if (v2Settings != null) return v2Settings.XmlText; return XmlSerializationHelper.WriteObjectToXmlText(this); } set { if (v2Settings != null) v2Settings.XmlText = value; else XmlSerializationHelper.ReadObjectFromXmlText(value, this); } } /// /// Releases all resources used by this class. /// public void Dispose() { if (v2Settings != null) Marshal.ReleaseComObject(v2Settings); idleSettings = null; networkSettings = null; v1Task = null; } /// /// Returns a that represents this instance. /// /// /// A that represents this instance. /// public override string ToString() { if (v2Settings != null || v1Task != null) return DebugHelper.GetDebugString(this); return base.ToString(); } XmlSchema IXmlSerializable.GetSchema() { return null; } void IXmlSerializable.ReadXml(XmlReader reader) { if (!reader.IsEmptyElement) { reader.ReadStartElement("Settings", TaskDefinition.tns); XmlSerializationHelper.ReadObjectProperties(reader, this, this.ConvertXmlProperty); reader.ReadEndElement(); } else reader.Skip(); } void IXmlSerializable.WriteXml(XmlWriter writer) { XmlSerializationHelper.WriteObjectProperties(writer, this, this.ConvertXmlProperty); } bool ConvertXmlProperty(System.Reflection.PropertyInfo pi, Object obj, ref Object value) { if (pi.Name == "Priority") { if (value.GetType() == typeof(int) || value.GetType() == typeof(System.Diagnostics.ProcessPriorityClass)) value = this.GetPriorityFromInt((int)value); else value = this.GetPriorityAsInt((System.Diagnostics.ProcessPriorityClass)value); return true; } return false; } } }