/* * Copyright (c) 2020 ETH Zürich, Educational Development and Technology (LET) * * 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; using System.Diagnostics; using System.IO; using System.Linq; using System.Threading; using SafeExamBrowser.Logging.Contracts; using SafeExamBrowser.WindowsApi.Contracts; using SafeExamBrowser.WindowsApi.Types; namespace SafeExamBrowser.WindowsApi { public class ExplorerShell : IExplorerShell { private ILogger logger; private INativeMethods nativeMethods; private IList minimizedWindows = new List(); private IList suspendedThreads; public ExplorerShell(ILogger logger, INativeMethods nativeMethods) { this.logger = logger; this.nativeMethods = nativeMethods; this.minimizedWindows = new List(); this.suspendedThreads = new List(); } public void HideAllWindows() { logger.Info("Searching for windows to be minimized..."); foreach (var handle in nativeMethods.GetOpenWindows()) { var window = new Window { Handle = handle, Title = nativeMethods.GetWindowTitle(handle) }; minimizedWindows.Add(window); logger.Info($"Found window '{window.Title}' with handle = {window.Handle}."); } logger.Info("Minimizing all open windows..."); nativeMethods.MinimizeAllOpenWindows(); logger.Info("Open windows successfully minimized."); } public void RestoreAllWindows() { logger.Info("Restoring all minimized windows..."); foreach (var window in minimizedWindows) { nativeMethods.RestoreWindow(window.Handle); logger.Info($"Restored window '{window.Title}' with handle = {window.Handle}."); } minimizedWindows.Clear(); logger.Info("Minimized windows successfully restored."); } public void Resume() { const int MAX_ATTEMPTS = 3; logger.Debug($"Attempting to resume all {suspendedThreads.Count} previously suspended explorer shell threads..."); for (var attempts = 0; suspendedThreads.Any(); attempts++) { var thread = suspendedThreads.First(); var success = nativeMethods.ResumeThread(thread.Id); if (success || attempts == MAX_ATTEMPTS) { attempts = 0; suspendedThreads.Remove(thread); if (!success) { logger.Warn($"Failed to resume explorer shell thread with ID = {thread.Id} within {MAX_ATTEMPTS} attempts!"); } } } logger.Info($"Successfully resumed explorer shell process."); } public void Start() { var process = new System.Diagnostics.Process(); var explorerPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Windows), "explorer.exe"); logger.Debug("Starting explorer shell process..."); process.StartInfo.CreateNoWindow = true; process.StartInfo.FileName = explorerPath; process.Start(); logger.Debug("Waiting for explorer shell to initialize..."); while (nativeMethods.GetShellWindowHandle() == IntPtr.Zero) { Thread.Sleep(20); } process.Refresh(); logger.Info($"Explorer shell successfully started with PID = {process.Id}."); process.Close(); } public void Suspend() { var processId = nativeMethods.GetShellProcessId(); var explorerProcesses = System.Diagnostics.Process.GetProcessesByName("explorer"); var process = explorerProcesses.FirstOrDefault(p => p.Id == processId); if (process != null) { logger.Debug($"Found explorer shell processes with PID = {processId} and {process.Threads.Count} threads."); foreach (ProcessThread thread in process.Threads) { var success = nativeMethods.SuspendThread(thread.Id); if (success) { suspendedThreads.Add(thread); } else { logger.Warn($"Failed to suspend explorer shell thread with ID = {thread.Id}!"); } } logger.Info($"Successfully suspended explorer shell process with PID = {processId}."); process.Close(); } else { logger.Info("The explorer shell can't be suspended, as it seems to not be running."); } } public void Terminate() { const int THREE_SECONDS = 3000; var processId = nativeMethods.GetShellProcessId(); var explorerProcesses = System.Diagnostics.Process.GetProcessesByName("explorer"); var process = explorerProcesses.FirstOrDefault(p => p.Id == processId); if (process != null) { logger.Debug($"Found explorer shell processes with PID = {processId}. Sending close message..."); nativeMethods.PostCloseMessageToShell(); logger.Debug("Waiting for explorer shell to terminate..."); while (nativeMethods.GetShellWindowHandle() != IntPtr.Zero) { Thread.Sleep(20); } process.WaitForExit(THREE_SECONDS); process.Refresh(); if (!process.HasExited) { KillExplorerShell(process.Id); } process.Refresh(); if (process.HasExited) { logger.Info($"Successfully terminated explorer shell process with PID = {processId}."); } else { logger.Error($"Failed to completely terminate explorer shell process with PID = {processId}."); } process.Close(); } else { logger.Info("The explorer shell seems to already be terminated."); } } private void KillExplorerShell(int processId) { var process = new System.Diagnostics.Process(); var taskkillPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), "taskkill.exe"); logger.Warn("Failed to gracefully terminate, attempting forceful termination..."); process.StartInfo.Arguments = $"/F /PID {processId}"; process.StartInfo.CreateNoWindow = true; process.StartInfo.FileName = taskkillPath; process.StartInfo.WindowStyle = ProcessWindowStyle.Hidden; process.Start(); process.WaitForExit(); } } }