74 lines
2.5 KiB
C#
74 lines
2.5 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 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;
|
|
}
|
|
}
|