Restore SEBPatch

SafeExamBrowser.Communication.Contracts/Hosts/IRuntimeHost.cs

@@ -0,0 +1,74 @@
+/*
+ * 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 SafeExamBrowser.Communication.Contracts.Events;
+
+namespace SafeExamBrowser.Communication.Contracts.Hosts
+{
+	/// <summary>
+	/// Defines the functionality of the communication host for the runtime application component.
+	/// </summary>
+	public interface IRuntimeHost : ICommunicationHost
+	{
+		/// <summary>
+		/// Determines whether another application component may establish a connection with the host.
+		/// </summary>
+		bool AllowConnection { get; set; }
+
+		/// <summary>
+		/// The token used for initial authentication.
+		/// </summary>
+		Guid? AuthenticationToken { set; }
+
+		/// <summary>
+		/// Event fired when the client disconnected from the runtime.
+		/// </summary>
+		event CommunicationEventHandler ClientDisconnected;
+
+		/// <summary>
+		/// Event fired when the client has signaled that it is ready to operate.
+		/// </summary>
+		event CommunicationEventHandler ClientReady;
+
+		/// <summary>
+		/// Event fired when the client requested its configuration data.
+		/// </summary>
+		event CommunicationEventHandler<ClientConfigurationEventArgs> ClientConfigurationNeeded;
+
+		/// <summary>
+		/// Event fired when the client submitted a server exam selection made by the user.
+		/// </summary>
+		event CommunicationEventHandler<ExamSelectionReplyEventArgs> ExamSelectionReceived;
+
+		/// <summary>
+		/// Event fired when the client submitted a message box result chosen by the user.
+		/// </summary>
+		event CommunicationEventHandler<MessageBoxReplyEventArgs> MessageBoxReplyReceived;
+
+		/// <summary>
+		/// Event fired when the client submitted a password entered by the user.
+		/// </summary>
+		event CommunicationEventHandler<PasswordReplyEventArgs> PasswordReceived;
+
+		/// <summary>
+		/// Event fired when the client requested a reconfiguration of the application.
+		/// </summary>
+		event CommunicationEventHandler<ReconfigurationEventArgs> ReconfigurationRequested;
+
+		/// <summary>
+		/// Event fired when the client submitted a server failure action chosen by the user.
+		/// </summary>
+		event CommunicationEventHandler<ServerFailureActionReplyEventArgs> ServerFailureActionReceived;
+
+		/// <summary>
+		/// Event fired when the client requests to shut down the application.
+		/// </summary>
+		event CommunicationEventHandler ShutdownRequested;
+	}
+}