/// <summary>
/// Initializes a new instance of the <see cref="TaskService"/> class.
/// </summary>
/// <param name="targetServer">The target server. A null value implies the local machine.</param>
/// <param name="userName">Name of the user.</param>
/// <param name="accountDomain">The account domain.</param>
/// <param name="password">The password.</param>
/// <param name="forceV1">If set to <c>true</c> force Task Scheduler 1.0 compatibility.</param>
public TaskService(string targetServer, string userName, string accountDomain, string password, bool forceV1)
{
if (hasV2 && !forceV1)
{
v2 = true;
v2TaskService = new V2Interop.TaskSchedulerClass();
if (!string.IsNullOrEmpty(targetServer))
{
// Check to ensure character only server name. (Suggested by bigsan)
if (targetServer.StartsWith(@"\"))
targetServer = targetServer.TrimStart('\\');
// Make sure null is provided for local machine to compensate for a native library oddity (Found by ctrollen)
if (targetServer.Equals(Environment.MachineName, StringComparison.CurrentCultureIgnoreCase))
targetServer = null;
}
v2TaskService.Connect(targetServer, userName, accountDomain, password);
}
else
{
v1Impersonation = new WindowsImpersonatedIdentity(userName, accountDomain, password);
V1Interop.CTaskScheduler csched = new V1Interop.CTaskScheduler();
v1TaskScheduler = (V1Interop.ITaskScheduler)csched;
if (!string.IsNullOrEmpty(targetServer))
{
// Check to ensure UNC format for server name. (Suggested by bigsan)
if (!targetServer.StartsWith(@"\\"))
targetServer = @"\\" + targetServer;
v1TaskScheduler.SetTargetComputer(targetServer);
}
}
}
/// <summary>
/// Connects this instance of the <see cref="TaskService"/> class to a running Task Scheduler.
/// </summary>
private void Connect()
{
ResetUnsetProperties();
if (!initializing && !DesignMode)
{
if (((!string.IsNullOrEmpty(userDomain) && !string.IsNullOrEmpty(userName) && !string.IsNullOrEmpty(userPassword)) ||
(string.IsNullOrEmpty(userDomain) && string.IsNullOrEmpty(userName) && string.IsNullOrEmpty(userPassword))))
{
// Clear stuff if already connected
if (this.v2TaskService != null || this.v1TaskScheduler != null)
this.Dispose(true);
if (hasV2 && !forceV1)
{
v2TaskService = new V2Interop.TaskSchedulerClass();
if (!string.IsNullOrEmpty(targetServer))
{
// Check to ensure character only server name. (Suggested by bigsan)
if (targetServer.StartsWith(@"\"))
targetServer = targetServer.TrimStart('\\');
// Make sure null is provided for local machine to compensate for a native library oddity (Found by ctrollen)
if (targetServer.Equals(Environment.MachineName, StringComparison.CurrentCultureIgnoreCase))
targetServer = null;
}
else
targetServer = null;
v2TaskService.Connect(targetServer, userName, userDomain, userPassword);
targetServer = v2TaskService.TargetServer;
userName = v2TaskService.ConnectedUser;
userDomain = v2TaskService.ConnectedDomain;
maxVer = GetV2Version();
}
else
{
v1Impersonation = new WindowsImpersonatedIdentity(userName, userDomain, userPassword);
V1Interop.CTaskScheduler csched = new V1Interop.CTaskScheduler();
v1TaskScheduler = (V1Interop.ITaskScheduler)csched;
if (!string.IsNullOrEmpty(targetServer))
{
// Check to ensure UNC format for server name. (Suggested by bigsan)
if (!targetServer.StartsWith(@"\\"))
targetServer = @"\\" + targetServer;
}
else
targetServer = null;
v1TaskScheduler.SetTargetComputer(targetServer);
targetServer = v1TaskScheduler.GetTargetComputer();
maxVer = v1Ver;
}
}
else
{
throw new ArgumentException("A username, password, and domain must be provided.");
}
}
}
/// <summary>
/// Releases the unmanaged resources used by the <see cref="T:System.ComponentModel.Component"/> and optionally releases the managed resources.
/// </summary>
/// <param name="disposing">true to release both managed and unmanaged resources; false to release only unmanaged resources.</param>
protected override void Dispose(bool disposing)
{
if (v2TaskService != null)
{
Marshal.ReleaseComObject(v2TaskService);
v2TaskService = null;
}
if (v1TaskScheduler != null)
{
Marshal.ReleaseComObject(v1TaskScheduler);
v1TaskScheduler = null;
}
if (v1Impersonation != null)
{
v1Impersonation.Dispose();
v1Impersonation = null;
}
base.Dispose(disposing);
}