SEBPatch/SafeExamBrowser.Settings/Applications/WhitelistApplication.cs

92 lines
2.7 KiB
C#

/*
* Copyright (c) 2024 ETH Zürich, IT Services
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*/
using System;
using System.Collections.Generic;
namespace SafeExamBrowser.Settings.Applications
{
/// <summary>
/// Defines an application which is whitelisted, i.e. allowed to run during a session.
/// </summary>
[Serializable]
public class WhitelistApplication
{
/// <summary>
/// Determines whether the user may choose a custom path if the main executable cannot be found under <see cref="ExecutablePath"/>.
/// </summary>
public bool AllowCustomPath { get; set; }
/// <summary>
/// Determines whether the application may already be running when initializing a session. If <c>true</c>, <see cref="AutoTerminate"/> will be ignored.
/// </summary>
public bool AllowRunning { get; set; }
/// <summary>
/// The list of arguments to be used when starting the application.
/// </summary>
public IList<string> Arguments { get; }
/// <summary>
/// Determines whether the application will be automatically started when initializing a session.
/// </summary>
public bool AutoStart { get; set; }
/// <summary>
/// Specifies whether the application may be automatically terminated when starting a session. Is ignored if <see cref="AllowRunning"/> is set.
/// </summary>
public bool AutoTerminate { get; set; }
/// <summary>
/// Provides further information about the application.
/// </summary>
public string Description { get; set; }
/// <summary>
/// The display name to be used for the application (e.g. in the shell).
/// </summary>
public string DisplayName { get; set; }
/// <summary>
/// The file name of the main executable of the application.
/// </summary>
public string ExecutableName { get; set; }
/// <summary>
/// The path where the main executable of the application is located.
/// </summary>
public string ExecutablePath { get; set; }
/// <summary>
/// Unique identifier to be used to identify the application during runtime.
/// </summary>
public Guid Id { get; }
/// <summary>
/// The original file name of the main executable of the application, if available.
/// </summary>
public string OriginalName { get; set; }
/// <summary>
/// Determines whether the user will be able to access the application via the shell.
/// </summary>
public bool ShowInShell { get; set; }
/// <summary>
/// The signature of the main executable of the application, if available.
/// </summary>
public string Signature { get; set; }
public WhitelistApplication()
{
Arguments = new List<string>();
Id = Guid.NewGuid();
}
}
}