Работа с устройствами печати в C# на примере реализации виртуального принтера

/// <summary>
/// Представляет API для работы со службой печати.
/// </summary>
public class PrintingApi
{
    /// <summary>
    /// Вспомагательный делегат для оптимизации кода в P/Invoke.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="level">Уровень структуры данных.</param>
    /// <param name="structs">Указатель на структуру данных.</param>
    /// <param name="bufferSize">Размер буфера.</param>
    /// <param name="bytesNeeded">Число требуемых байт для выделения памяти.</param>
    /// <param name="bufferReturnedLength">Число выделенных байт памяти.</param>
    /// <returns></returns>
    internal delegate bool EnumInfo(string serverName, uint level, IntPtr structs, uint bufferSize, ref uint bytesNeeded, ref uint bufferReturnedLength);

    /// <summary>
    /// Вспомагательный делегат для оптимизации кода в P/Invoke.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="environment">Окружение.</param>
    /// <param name="level">Уровень структуры данных.</param>
    /// <param name="structs">Указатель на структуру данных.</param>
    /// <param name="bufferSize">Размер буфера.</param>
    /// <param name="bytesNeeded">Число требуемых байт для выделения памяти.</param>
    /// <param name="bufferReturnedLength">Число выделенных байт памяти.</param>
    /// <returns></returns>
    internal delegate bool EnumInfo2(string serverName, string environment, uint level, IntPtr structs, uint bufferSize, ref uint bytesNeeded, ref uint bufferReturnedLength);

    /// <summary>
    /// Фабрика классов для <see cref="PrintingApi"/>.
    /// </summary>
    public static PrintingApi Factory { get; protected set; }

    /// <summary>
    /// Статический инициализатор класса <see cref="PrintingApi"/>.
    /// </summary>
    static PrintingApi()
    {
        Factory = new PrintingApi();
    }

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <returns>Коллекция нативных структур Spooler API.</returns>
    internal static T[] GetInfo<T>(EnumInfo handler, string serverName, uint level) where T : struct
    {
        uint bytesNeeded = 0;
        uint bufferReturnedLength = 0;

        if (handler(serverName, level, IntPtr.Zero, 0, ref bytesNeeded, ref bufferReturnedLength)) return null;

        int lastWin32Error = Marshal.GetLastWin32Error();

        if (lastWin32Error != PrintingException.ErrorInsufficientBuffer) throw new PrintingException(lastWin32Error);

        IntPtr pointer = Marshal.AllocHGlobal((int)bytesNeeded);

        try
        {
            if (handler(serverName, level, pointer, bytesNeeded, ref bytesNeeded, ref bufferReturnedLength))
            {
                IntPtr currentPointer = pointer;
                T[] dataCollection = new T[bufferReturnedLength];
                Type type = typeof(T);

                for (int i = 0; i < bufferReturnedLength; i++)
                {
                    dataCollection[i] = (T)Marshal.PtrToStructure(currentPointer, type);
                    currentPointer = (IntPtr)(currentPointer.ToInt64() + Marshal.SizeOf(type));
                }

                return dataCollection;
            }

            throw new PrintingException(Marshal.GetLastWin32Error());
        }
        catch (Exception e)
        {
            throw new PrintingException(e.Message, e);
        }
        finally
        {
            Marshal.FreeHGlobal(pointer);
        }
    }

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <returns>Коллекция нативных структур Spooler API.</returns>
    internal static T[] GetInfo<T>(EnumInfo handler, string serverName) where T : struct => GetInfo<T>(handler, serverName, 2);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <returns>Коллекция нативных структур Spooler API.</returns>
    internal static T[] GetInfo<T>(EnumInfo handler, uint level) where T : struct => GetInfo<T>(handler, null, level);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <returns>Коллекция нативных структур Spooler API.</returns>
    internal static T[] GetInfo<T>(EnumInfo handler) where T : struct => GetInfo<T>(handler, null);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="arg">Дополнительный аргумент делегата.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <returns>Коллекция нативных структур Spooler API.</returns>
    internal static T[] GetInfo<T>(EnumInfo2 handler, string serverName, string arg, uint level) where T : struct
    {
        uint bytesNeeded = 0;
        uint bufferReturnedLength = 0;

        if (handler(serverName, arg, level, IntPtr.Zero, 0, ref bytesNeeded, ref bufferReturnedLength)) return null;

        int lastWin32Error = Marshal.GetLastWin32Error();

        if (lastWin32Error != PrintingException.ErrorInsufficientBuffer) throw new PrintingException(lastWin32Error);

        IntPtr pointer = Marshal.AllocHGlobal((int)bytesNeeded);

        try
        {
            if (handler(serverName, arg, level, pointer, bytesNeeded, ref bytesNeeded, ref bufferReturnedLength))
            {
                IntPtr currentPointer = pointer;
                T[] dataCollection = new T[bufferReturnedLength];
                Type type = typeof(T);

                for (int i = 0; i < bufferReturnedLength; i++)
                {
                    dataCollection[i] = (T)Marshal.PtrToStructure(currentPointer, type);
                    currentPointer = (IntPtr)(currentPointer.ToInt64() + Marshal.SizeOf(type));
                }

                return dataCollection;
            }

            throw new PrintingException(Marshal.GetLastWin32Error());
        }
        catch (Exception e)
        {
            throw new PrintingException(e.Message, e);
        }
        finally
        {
            Marshal.FreeHGlobal(pointer);
        }
    }

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="arg">Дополнительный аргумент делегата.</param>
    /// <returns>Коллекция нативных структур Spooler API.</returns>
    internal static T[] GetInfo<T>(EnumInfo2 handler, string serverName, string arg) where T : struct => GetInfo<T>(handler, serverName, arg, 2);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="arg">Дополнительный аргумент делегата.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <returns>Коллекция нативных структур Spooler API.</returns>
    internal static T[] GetInfo<T>(EnumInfo2 handler, string arg, uint level) where T : struct => GetInfo<T>(handler, null, arg, level);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="arg">Дополнительный аргумент делегата.</param>
    /// <returns>Коллекция нативных структур Spooler API.</returns>
    internal static T[] GetInfo<T>(EnumInfo2 handler, string arg) where T : struct => GetInfo<T>(handler, null, arg);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <returns>Коллекция нативных структур Spooler API.</returns>
    internal static T[] GetInfo<T>(EnumInfo2 handler, uint level) where T : struct => GetInfo<T>(handler, null, level);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <returns>Коллекция нативных структур Spooler API.</returns>
    internal static T[] GetInfo<T>(EnumInfo2 handler) where T : struct => GetInfo<T>(handler, null);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <param name="e">Исключение, возникшее во время операции.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo handler, string serverName, uint level, out T[] dataCollection, out PrintingException e) where T : struct
    {
        dataCollection = null;
        e = null;

        try
        {
            dataCollection = GetInfo<T>(handler, serverName, level);
            return true;
        }
        catch (PrintingException ex)
        {
            e = ex;
        }

        return false;
    }

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo handler, string serverName, uint level, out T[] dataCollection) where T : struct
        => TryGetInfo(handler, serverName, level, out dataCollection, out PrintingException e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <param name="e">Исключение, возникшее во время операции.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo handler, string serverName, out T[] dataCollection, out PrintingException e) where T : struct
        => TryGetInfo(handler, serverName, 2, out dataCollection, out e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo handler, string serverName, out T[] dataCollection) where T : struct
        => TryGetInfo(handler, serverName, 2, out dataCollection, out PrintingException e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <param name="e">Исключение, возникшее во время операции.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo handler, uint level, out T[] dataCollection, out PrintingException e) where T : struct
        => TryGetInfo(handler, null, level, out dataCollection, out e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo handler, uint level, out T[] dataCollection) where T : struct
        => TryGetInfo(handler, null, level, out dataCollection, out PrintingException e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <param name="e">Исключение, возникшее во время операции.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo handler, out T[] dataCollection, out PrintingException e) where T : struct
        => TryGetInfo(handler, null, out dataCollection, out e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo handler, out T[] dataCollection) where T : struct
        => TryGetInfo(handler, null, out dataCollection, out PrintingException e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="arg">Дополнительный аргумент делегата.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <param name="e">Исключение, возникшее во время операции.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo2 handler, string serverName, string arg, uint level, out T[] dataCollection, out PrintingException e) where T : struct
    {
        dataCollection = null;
        e = null;

        try
        {
            dataCollection = GetInfo<T>(handler, serverName, arg, level);
            return true;
        }
        catch (PrintingException ex)
        {
            e = ex;
        }

        return false;
    }

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="arg">Дополнительный аргумент делегата.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo2 handler, string serverName, string arg, uint level, out T[] dataCollection) where T : struct
        => TryGetInfo(handler, serverName, arg, level, out dataCollection, out PrintingException e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="arg">Дополнительный аргумент делегата.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <param name="e">Исключение, возникшее во время операции.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo2 handler, string serverName, string arg, out T[] dataCollection, out PrintingException e) where T : struct
        => TryGetInfo(handler, serverName, arg, 2, out dataCollection, out e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="arg">Дополнительный аргумент делегата.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo2 handler, string serverName, string arg, out T[] dataCollection) where T : struct
        => TryGetInfo(handler, serverName, arg, 2, out dataCollection, out PrintingException e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="arg">Дополнительный аргумент делегата.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <param name="e">Исключение, возникшее во время операции.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo2 handler, string arg, uint level, out T[] dataCollection, out PrintingException e) where T : struct
        => TryGetInfo(handler, null, arg, level, out dataCollection, out e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="arg">Дополнительный аргумент делегата.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo2 handler, string arg, uint level, out T[] dataCollection) where T : struct
        => TryGetInfo(handler, null, arg, level, out dataCollection, out PrintingException e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="arg">Дополнительный аргумент делегата.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <param name="e">Исключение, возникшее во время операции.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo2 handler, string arg, out T[] dataCollection, out PrintingException e) where T : struct
        => TryGetInfo(handler, null, arg, out dataCollection, out e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="arg">Дополнительный аргумент делегата.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo2 handler, string arg, out T[] dataCollection) where T : struct
        => TryGetInfo(handler, null, arg, out dataCollection, out PrintingException e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <param name="e">Исключение, возникшее во время операции.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo2 handler, uint level, out T[] dataCollection, out PrintingException e) where T : struct
        => TryGetInfo(handler, null, level, out dataCollection, out e);
        
    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo2 handler, uint level, out T[] dataCollection) where T : struct
        => TryGetInfo(handler, null, level, out dataCollection, out PrintingException e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <param name="e">Исключение, возникшее во время операции.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo2 handler, out T[] dataCollection, out PrintingException e) where T : struct
        => TryGetInfo(handler, null, out dataCollection, out e);

    /// <summary>
    /// Получает коллекцию нативных структур Spooler API и в случае успеха возвращает True. Вспомагательный метод для оптимизации кода в P/Invoke.
    /// </summary>
    /// <typeparam name="T">Тип структуры.</typeparam>
    /// <param name="handler">Делегат-обработчик нативного метода из Spooler API.</param>
    /// <param name="dataCollection">Коллекция нативных структур Spooler API.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    internal static bool TryGetInfo<T>(EnumInfo2 handler, out T[] dataCollection) where T : struct
        => TryGetInfo(handler, null, out dataCollection, out PrintingException e);
}

/// <summary>
/// Представляет ошибку менеджера печати.
/// </summary>
[Serializable]
public class PrintingException : Win32Exception
{
    #region Error Codes
    /// <summary>
    /// Код ошибки "Файл не найден".
    /// </summary>
    public const int ErrorFileNotFound = 2;

    /// <summary>
    /// Код ошибки "Неинициализированный буфер".
    /// </summary>
    public const int ErrorInsufficientBuffer = 122;

    /// <summary>
    /// Код ошибки "Модуль не найден".
    /// </summary>
    public const int ErrorModuleNotFound = 126;

    /// <summary>
    /// Код ошибки "Имя принтера задано неверно".
    /// </summary>
    public const int ErrorInvalidPrinterName = 1801;

    /// <summary>
    /// Код ошибки "Указан неизвестный монитор печати".
    /// </summary>
    public const int ErrorMonitorUnknown = 3000;

    /// <summary>
    /// Код ошибки "Указанный драйвер принтера занят".
    /// </summary>
    public const int ErrorPrinterDriverIsReadyUsed = 3001;

    /// <summary>
    /// Код ошибки "Не найден файл диспетчера очереди".
    /// </summary>
    public const int ErrorPrinterJobFileNotFound = 3002;

    /// <summary>
    /// Код ошибки "Не был произведен вызов StartDocPrinter".
    /// </summary>
    public const int ErrorStartDocPrinterNotCalling = 3003;

    /// <summary>
    /// Код ошибки "Не был произведен вызов AddJob".
    /// </summary>
    public const int ErrorAddJobNotCalling = 3004;

    /// <summary>
    /// Код ошибки "Указанный процессор печати уже установлен".
    /// </summary>
    public const int ErrorPrinterProcessorAlreadyInstalled = 3005;

    /// <summary>
    /// Код ошибки "Указанный монитор печати уже установлен".
    /// </summary>
    public const int ErrorMonitorAlreadyInstalled = 3006;

    /// <summary>
    /// Код ошибки "Указанный монитор печати не имеет требуемых функций".
    /// </summary>
    public const int ErrorInvalidMonitor = 3007;

    /// <summary>
    /// Код ошибки "Указанный монитор печати сейчас уже используется".
    /// </summary>
    public const int ErrorMonitorIsReadyUsed = 3008;
    #endregion

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="PrintingException"/>.
    /// </summary>
    public PrintingException() : base() { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="PrintingException"/>.
    /// </summary>
    /// <param name="nativeErrorCode">Код ошибки Win32.</param>
    public PrintingException(int nativeErrorCode) : base(nativeErrorCode) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="PrintingException"/>.
    /// </summary>
    /// <param name="message">Сообщение об ошибке.</param>
    public PrintingException(string message) : base(message) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="PrintingException"/>.
    /// </summary>
    /// <param name="nativeErrorCode">Код ошибки Win32.</param>
    /// <param name="message">Сообщение об ошибке.</param>
    public PrintingException(int nativeErrorCode, string message) : base(nativeErrorCode, message) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="PrintingException"/>.
    /// </summary>
    /// <param name="message">Сообщение об ошибке.</param>
    /// <param name="innerException"></param>
    public PrintingException(string message, Exception innerException) : base(message, innerException) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="PrintingException"/>.
    /// </summary>
    /// <param name="info">Данные для сериализации.</param>
    /// <param name="context">Контекст потока сериализации.</param>
    public PrintingException(SerializationInfo info, StreamingContext context) : base(info, context) { }
}

/// <summary>
/// Представляет базовый класс для всех компонентов устройства печати.
/// </summary>
public abstract class PrintableDevice : IPrintableDevice
{
    /// <summary>
    /// Наименование компонента устройства печати.
    /// </summary>
    public virtual string Name { get; protected set; }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="PrintableDevice"/>.
    /// </summary>
    /// <param name="name"></param>
    /// <exception cref="ArgumentNullException"/>
    public PrintableDevice(string name)
    {
        if (string.IsNullOrEmpty(name)) throw new ArgumentNullException("name");

        Name = name;
    }

    /// <summary>
    /// Устанавливает компонента устройства печати на удалённой машине.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <exception cref="FileNotFoundException" />
    /// <exception cref="PrintingException" />
    public abstract void Install(string serverName);

    /// <summary>
    /// Устанавливает компонента устройства печати на локальной машине.
    /// </summary>
    /// <exception cref="FileNotFoundException" />
    /// <exception cref="PrintingException" />
    public void Install() => Install(null);

    /// <summary>
    /// Устанавливает компонента устройства печати на удалённой машине.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="e">Исключение, возникшее в процессе установки.</param>
    /// <returns>True, если процедура установки прошла успешно, иначе False.</returns>
    public bool TryInstall(string serverName, out PrintingException e)
    {
        e = null;

        try
        {
            Install(serverName);
        }
        catch (PrintingException ex)
        {
            e = ex;
            return false;
        }

        return true;
    }

    /// <summary>
    /// Устанавливает компонента устройства печати на удалённой машине.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <returns>True, если процедура установки прошла успешно, иначе False.</returns>
    public bool TryInstall(string serverName) => TryInstall(serverName, out PrintingException e);

    /// <summary>
    /// Устанавливает компонента устройства печати на локальной машине.
    /// </summary>
    /// <param name="e">Исключение, возникшее в процессе установки.</param>
    /// <returns>True, если процедура установки прошла успешно, иначе False.</returns>
    public bool TryInstall(out PrintingException e) => TryInstall(null, out e);

    /// <summary>
    /// Устанавливает компонента устройства печати на локальной машине.
    /// </summary>
    /// <returns>True, если процедура установки прошла успешно, иначе False.</returns>
    public bool TryInstall() => TryInstall(out PrintingException e);

    /// <summary>
    /// Удалает компонента устройства печати на удалённой машине.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <exception cref="PrintingException" />
    public abstract void Uninstall(string serverName);

    /// <summary>
    /// Удаляет компонента устройства печати на локальной машине.
    /// </summary>
    /// <exception cref="PrintingException" />
    public void Uninstall() => Uninstall(null);

    /// <summary>
    /// Удалает компонента устройства печати на удалённой машине.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="e">Исключение, возникшее в процессе удаления.</param>
    /// <returns>True, если процедура удаления прошла успешно, иначе False.</returns>
    public bool TryUninstall(string serverName, out PrintingException e)
    {
        e = null;

        try
        {
            Uninstall(serverName);
        }
        catch (PrintingException ex)
        {
            e = ex;
            return false;
        }

        return true;
    }

    /// <summary>
    /// Удалает компонента устройства печати на удалённой машине.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <returns>True, если процедура удаления прошла успешно, иначе False.</returns>
    public bool TryUninstall(string serverName) => TryUninstall(serverName, out PrintingException e);

    /// <summary>
    /// Удалает компонента устройства печати на локальной машине.
    /// </summary>
    /// <param name="e">Исключение, возникшее в процессе удаления.</param>
    /// <returns>True, если процедура удаления прошла успешно, иначе False.</returns>
    public bool TryUninstall(out PrintingException e) => TryUninstall(null, out e);

    /// <summary>
    /// Удалает компонента устройства печати на локальной машине.
    /// </summary>
    /// <returns>True, если процедура удаления прошла успешно, иначе False.</returns>
    public bool TryUninstall() => TryUninstall(out PrintingException e);
}

/// <summary>
/// Представляет структуру для хранения информации о мониторе принтера.
/// </summary>
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)]
internal struct MonitorInfo
{
    /// <summary>
    /// Наименование монитора.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string Name;

    /// <summary>
    /// Окружение, для которого был написан драйвер (например, Windows NT x86, Windows IA64 или Windows x64).
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string Environment;

    /// <summary>
    /// Имя файла *.dll монитора.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string DllName;
}

/// <summary>
/// Представляет базовый интерфейс для реализации мониторов печати.
/// </summary>
public interface IMonitor : IPrintableDevice
{
    /// <summary>
    /// Окружение, для которого был написан драйвер (например, Windows NT x86, Windows IA64 или Windows x64).
    /// </summary>
    Environment Environment { get; }

    /// <summary>
    /// Имя файла *.dll монитора.
    /// </summary>
    string Dll { get; }
}

/// <summary>
/// Представляет монитор печати для открытия портов.
/// </summary>
public class Monitor : PrintableDevice, IMonitor
{
    /// <summary>
    /// Окружение, для которого был написан драйвер (например, Windows NT x86, Windows IA64 или Windows x64).
    /// </summary>
    public virtual Environment Environment { get; protected set; }

    /// <summary>
    /// Имя файла *.dll монитора.
    /// </summary>
    public virtual string Dll { get; protected set; }

    /// <summary>
    /// Возвращает список всех установленных в системе мониторов печати.
    /// </summary>
    public static Monitor[] All
    {
        get
        {
            if (!PrintingApi.TryGetInfo(EnumMonitors, out MonitorInfo[] monitorInfo)) return null;

            Monitor[] monitors = new Monitor[monitorInfo.Length];

            for (int i = 0; i < monitorInfo.Length; i++)
                monitors[i] = new Monitor(monitorInfo[i].Name, monitorInfo[i].DllName, monitorInfo[i].Environment.GetEnvironment());

            return monitors;
        }
    }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Monitor"/>.
    /// </summary>
    /// <param name="name">Наименование монитора печати.</param>
    /// <param name="dll">Имя файла *.dll монитора.</param>
    /// <param name="environment">Окружение, для которого был написан драйвер (например, Windows NT x86, Windows IA64 или Windows x64).</param>
    /// <exception cref="ArgumentNullException" />
    public Monitor(string name, string dll, Environment environment) : base(name)
    {
        if (string.IsNullOrEmpty(dll)) throw new ArgumentNullException("dll");

        Environment = environment;
        Dll = dll;
    }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Monitor"/>.
    /// </summary>
    /// <param name="name">Наименование монитора печати.</param>
    /// <param name="dll">Имя файла *.dll монитора.</param>
    /// <exception cref="ArgumentNullException" />
    public Monitor(string name, string dll) : this(name, dll, Environment.Current) { }

    /// <summary>
    /// Устанавливает монитор печати на удалённой машине.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <exception cref="FileNotFoundException"/>
    /// <exception cref="PrintingException"/>
    public override void Install(string serverName)
    {
        try
        {
            if (!File.Exists(Dll)) throw new FileNotFoundException("Не удалось найти файл монитора печати", Dll);

            string dllName = Path.GetFileName(Dll);
            string dllPath = Path.Combine(System.Environment.SystemDirectory, dllName);

            File.Copy(Dll, dllPath, true);

            MonitorInfo monitorInfo = new MonitorInfo
            {
                Name = Name,
                Environment = Environment.GetEnvironmentName(),
                DllName = File.Exists(dllPath) ? dllName : Dll,
            };

            if (AddMonitor(serverName, 2, ref monitorInfo)) return;

            if (Marshal.GetLastWin32Error() == PrintingException.ErrorMonitorAlreadyInstalled && TryUninstall(serverName)
                && AddMonitor(serverName, 2, ref monitorInfo))
                return;
            else
                throw new PrintingException(Marshal.GetLastWin32Error());
        }
        catch (Exception e)
        {
            throw new PrintingException(e.Message, e);
        }
    }

    /// <summary>
    /// Удалает монитор печати на удалённой машине.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <exception cref="PrintingException"/>
    public override void Uninstall(string serverName)
    {
        try
        {
            if (!All.Select(m => m.Name).Contains(Name)) return;

            /// TODO: Добавить удаление октрытых на мониторе портов.

            if (DeleteMonitor(serverName, Environment.GetEnvironmentName(), Name)) return;
            if (Marshal.GetLastWin32Error() == PrintingException.ErrorMonitorUnknown) return;
            if (DeleteMonitor(serverName, Environment.GetEnvironmentName(), Name)) return;

            throw new PrintingException(Marshal.GetLastWin32Error());
        }
        catch (Exception e)
        {
            throw new PrintingException(e.Message, e);
        }
    }

    #region Native
    /// <summary>
    /// Производит установку монитора принтера в систему.
    /// </summary>
    /// <param name="serverName">Имя сервера, на который необходимо произвести установку. Если равно null - устанавливает на локальную машину.</param>
    /// <param name="level">Номер версии структуры. Должен быть равен 2.</param>
    /// <param name="monitor">Экземпляр структуры <see cref="MonitorInfo"/>.</param>
    /// <returns>True, если операция выполнена успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool AddMonitor(string serverName, uint level, ref MonitorInfo monitor);

    /// <summary>
    /// Возвращает указатель на буфер экземпляров структур <see cref="MonitorInfo"/>.
    /// </summary>
    /// <param name="serverName">Имя сервера, с которого требуется получить список мониторов. Если равно null - получает на локальной машине.</param>
    /// <param name="level">Номер версии структуры. Должен быть равен 1 или 2.</param>
    /// <param name="monitors">Указатель на буфер экземпляров структур <see cref="MonitorInfo"/>.</param>
    /// <param name="bufferSize">Размер буфера экземпляров структур <see cref="MonitorInfo"/> (в байтах).</param>
    /// <param name="bytesNeeded">Число полученных байт размера буфера.</param>
    /// <param name="bufferReturnedLength">Число экземпляров структур.</param>
    /// <returns>True, если операция выполнена успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool EnumMonitors(string serverName, uint level, IntPtr monitors, uint bufferSize, ref uint bytesNeeded, ref uint bufferReturnedLength);

    /// <summary>
    /// Производит удаление монитора принтера из системы.
    /// </summary>
    /// <param name="serverName">Имя сервера, на который необходимо произвести установку. Если равно null - устанавливает на локальную машину.</param>
    /// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
    /// <param name="monitorName">Имя удаляемого монитора.</param>
    /// <returns>True, если операция выполнена успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool DeleteMonitor(string serverName, string environment, string monitorName);
    #endregion
}

/// <summary>
/// Возвращает коллекцию всех установленных мониторов в системе.
/// </summary>
public static Monitor[] Monitors => Monitor.All;

/// <summary>
/// Создаёт новый монитор печати в системе.
/// </summary>
/// <param name="name">Наименование монитора печати.</param>
/// <param name="dll">Путь к файлу dll монитора печати.</param>
/// <param name="environment">Окружение, для которого был написан монитор печати.</param>
/// <param name="serverName">Наименование сервера, на котором производится установка монитора печати.</param>
/// <returns>Экземпляр монитора печати.</returns>
public Monitor CreateMonitor(string name, string dll, Environment environment, string serverName)
{
	Monitor monitor = new Monitor(name, dll, environment);
	monitor.TryInstall(serverName);

	return monitor;
}

/// <summary>
/// Создаёт новый монитор печати в системе.
/// </summary>
/// <param name="name">Наименование монитора печати.</param>
/// <param name="dll">Путь к файлу dll монитора печати.</param>
/// <param name="environment">Окружение, для которого был написан монитор печати.</param>
/// <returns>Экземпляр монитора печати.</returns>
public Monitor CreateMonitor(string name, string dll, Environment environment) => CreateMonitor(name, dll, environment, null);

/// <summary>
/// Создаёт новый монитор печати в системе.
/// </summary>
/// <param name="name">Наименование монитора печати.</param>
/// <param name="dll">Путь к файлу dll монитора печати.</param>
/// <param name="serverName">Наименование сервера, на котором производится установка монитора печати.</param>
/// <returns>Экземпляр монитора печати.</returns>
public Monitor CreateMonitor(string name, string dll, string serverName) => CreateMonitor(name, dll, Environment.Current, null);

/// <summary>
/// Создаёт новый монитор печати в системе.
/// </summary>
/// <param name="name">Наименование монитора печати.</param>
/// <param name="dll">Путь к файлу dll монитора печати.</param>
/// <returns>Экземпляр монитора печати.</returns>
public Monitor CreateMonitor(string name, string dll) => CreateMonitor(name, dll, null);

/// <summary>
/// Представляет тестовый модуль класса <see cref="Monitor"/>.
/// </summary>
[TestClass]
public class MonitorTests
{
    /// <summary>
    /// Наименование монитора.
    /// </summary>
    protected const string MonitorName = "Test Monitor";

    /// <summary>
    /// Путь к dll монитора.
    /// </summary>
    protected const string MonitorDll = "D:/Printing Tests/mfilemon.dll";

    /// <summary>
    /// Неправильный путь к dll монитора.
    /// </summary>
    protected const string FailedMonitorDll = "noexist.dll";

    /// <summary>
    /// Тест локальной установки монитора.
    /// </summary>
    [TestMethod]
    public void InstallTest()
    {
        Monitor monitor = new Monitor(MonitorName, MonitorDll);
        monitor.Install();

        Assert.IsTrue(Monitor.All.Select(m => m.Name).Contains(MonitorName));
    }

    /// <summary>
    /// Тест локального удаления монитора.
    /// </summary>
    [TestMethod]
    public void UninstallTest()
    {
        Monitor monitor = new Monitor(MonitorName, MonitorDll);
        monitor.Uninstall();

        Assert.IsFalse(Monitor.All.Select(m => m.Name).Contains(MonitorName));
    }

    /// <summary>
    /// Тест локальной установки монитора с перехватом состояния установки.
    /// </summary>
    [TestMethod]
    public void TryInstallTest()
    {
        Monitor monitor = new Monitor(MonitorName, MonitorDll);
        bool f = monitor.TryInstall();

        Assert.IsTrue(f);
        Assert.IsTrue(Monitor.All.Select(m => m.Name).Contains(MonitorName));
    }

    /// <summary>
    /// Тест локального удаления монитора с перехватом состояния удаления.
    /// </summary>
    [TestMethod]
    public void TryUninstallTest()
    {
        Monitor monitor = new Monitor(MonitorName, MonitorDll);
        bool f = monitor.TryUninstall();

        Assert.IsTrue(f);
        Assert.IsFalse(Monitor.All.Select(m => m.Name).Contains(MonitorName));
    }

    /// <summary>
    /// Тест неправильной локальной установки монитора.
    /// </summary>
    [TestMethod]
    [ExpectedException(typeof(PrintingException))]
    public void InstallFailedTest()
    {
        Monitor monitor = new Monitor(MonitorName, FailedMonitorDll);
        monitor.Install();

        Assert.IsFalse(Monitor.All.Select(m => m.Name).Contains(MonitorName));
    }
        
    /// <summary>
    /// Тест неправильной локальной установки монитора с перехватом состояния установки.
    /// </summary>
    [TestMethod]
    public void TryInstallFailedTest()
    {
        Monitor monitor = new Monitor(MonitorName, FailedMonitorDll);
        bool f = monitor.TryInstall();

        Assert.IsFalse(f);
        Assert.IsFalse(Monitor.All.Select(m => m.Name).Contains(MonitorName));
    }

/// <summary>
/// Представляет базовый интерфейс для реализации портов печати.
/// </summary>
public interface IPort : IPrintableDevice
{
    /// <summary>
    /// Монитор, на котором открыт порт.
    /// </summary>
    IMonitor Monitor { get; }

    /// <summary>
    /// Описание порта.
    /// </summary>
    string Description { get; }

    /// <summary>
    /// Тип порта.
    /// </summary>
    PortType Type { get; }
}

/// <summary>
/// представляет информацию о порте монитора принтера.
/// </summary>
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)]
public struct PortInfo
{
    /// <summary>
    /// Наименование поддерживаемого порта (например, "LPT1:").
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string PortName;

    /// <summary>
    /// Наименование установленного монитора принтера (например, "PJL monitor"). Может быть равно null.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string MonitorName;

    /// <summary>
    /// Описание порта (например, если <see cref="PortName"/> равен "LPT1:", <see cref="Description"/> будет равен "printer port"). Может быть равно null.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string Description;

    /// <summary>
    /// Тип порта.
    /// </summary>
    public PortType Type;

    /// <summary>
    /// Зарезервировано. Должен быть равен 0.
    /// </summary>
    internal uint Reserved;
}

/// <summary>
/// Права доступа к принтеру.
/// </summary>
internal enum PrinterAccess
{
    /// <summary>
    /// Полный доступ к данным принтера.
    /// </summary>
    ServerAdmin = 0x01,
    /// <summary>
    /// Доступ к чтению данных принтера.
    /// </summary>
    ServerEnum = 0x02,
    /// <summary>
    /// Полный доступ к использованию принтера.
    /// </summary>
    PrinterAdmin = 0x04,
    /// <summary>
    /// Ограниченный доступ к использованию принтера.
    /// </summary>
    PrinterUse = 0x08,
    /// <summary>
    /// Полный доступ к данным очереди печати.
    /// </summary>
    JobAdmin = 0x10,
    /// <summary>
    /// Чтение данных очереди печати.
    /// </summary>
    JobRead = 0x20,
    /// <summary>
    /// Стандартные права доступа.
    /// </summary>
    StandardRightsRequired = 0x000F0000,
    /// <summary>
    /// Самый полный доступ.
    /// </summary>
    PrinterAllAccess = (StandardRightsRequired | PrinterAdmin | PrinterUse),
}

/// <summary>
/// Представляет установки принтера для <see cref="Port.XcvData(IntPtr, string, IntPtr, uint, IntPtr, uint, out uint, out uint)"/>.
/// </summary>
[StructLayout(LayoutKind.Sequential)]
internal struct PrinterDefaults
{
    /// <summary>
    /// Тип данных (по умолчанию равен null).
    /// </summary>
    public IntPtr DataType;

    /// <summary>
    /// Режим работы (по умолчанию равен null).
    /// </summary>
    public IntPtr DevMode;

    /// <summary>
    /// Права доступа к принтеру.
    /// </summary>
    public PrinterAccess DesiredAccess;
}

/// <summary>
/// Представляет данные принтера для <see cref="Port.XcvData(System.IntPtr, string, System.IntPtr, uint, System.IntPtr, uint, out uint, out uint)"/>.
/// </summary>
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)]
internal struct PortData
{
    /// <summary>
    /// Наименование порта.
    /// </summary>
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 64)]
    public string PortName;

    /// <summary>
    /// Номер версии (по умолчанию равен 1).
    /// </summary>
    public uint Version;

    /// <summary>
    /// Протокол.
    /// </summary>
    public DataType Protocol;

    /// <summary>
    /// Размер буфера данных.
    /// </summary>
    public uint BufferSize;

    /// <summary>
    /// Размер зарезервированного буфера.
    /// </summary>
    public uint ReservedSize;

    /// <summary>
    /// Адрес хоста.
    /// </summary>
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 49)]
    public string HostAddress;

    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 33)]
    public string SNMPCommunity;

    public uint DoubleSpool;

    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 33)]
    public string Queue;

    /// <summary>
    /// IP-адрес.
    /// </summary>
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 16)]
    public string IPAddress;

    /// <summary>
    /// Зарезервированный буфер.
    /// </summary>
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 540)]
    public byte[] Reserved;

    /// <summary>
    /// Номер порта.
    /// </summary>
    public uint PortNumber;

    public uint SNMPEnabled;

    public uint SNMPDevIndex;
}

/// <summary>
/// Тип операции для <see cref="Port.XcvData(IntPtr, string, IntPtr, uint, IntPtr, uint, out uint, out uint)"/>.
/// </summary>
internal enum XcvDataType
{
    /// <summary>
    /// Добавить новый порт.
    /// </summary>
    AddPort,
    /// <summary>
    /// Удалить существующий порт.
    /// </summary>
    DeletePort,
}

/// <summary>
/// Представляет порт для запуска принтера.
/// </summary>
public class Port : PrintableDevice, IPort
{
    /// <summary>
    /// Монитор, на котором открыт порт.
    /// </summary>
    public virtual IMonitor Monitor { get; protected set; }

    /// <summary>
    /// Описание порта.
    /// </summary>
    public virtual string Description { get; protected set; }

    /// <summary>
    /// Тип порта.
    /// </summary>
    public virtual PortType Type { get; protected set; }

    /// <summary>
    /// Возвращает список всех установленных в системе портов печати.
    /// </summary>
    public static Port[] All
    {
        get
        {
            if (!PrintingApi.TryGetInfo(EnumPorts, out PortInfo[] portInfo)) return null;

            Port[] ports = new Port[portInfo.Length];

            for (int i = 0; i < portInfo.Length; i++)
                ports[i] = new Port(portInfo[i].PortName, portInfo[i].Description, portInfo[i].Type, portInfo[i].MonitorName);

            return ports;
        }
    }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Port"/>.
    /// </summary>
    /// <param name="name">Наименование порта.</param>
    /// <param name="description">Описание порта.</param>
    /// <param name="type">Тип порта.</param>
    /// <param name="monitorName">Наименование монитора печати, на котором открыт порт.</param>
    /// <exception cref="ArgumentNullException"/>
    /// <exception cref="PrintingException"/>
    public Port(string name, string description, PortType type, string monitorName) : base(name)
    {
        Description = description;
        Type = type;

        Monitor[] monitors = PrintingApi.Monitors;

        if (monitors.Select(m => m.Name).Contains(monitorName)) Monitor = monitors.Where(m => m.Name == monitorName).FirstOrDefault();
    }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Port"/>.
    /// </summary>
    /// <param name="name">Наименование порта.</param>
    /// <param name="description">Описание порта.</param>
    /// <param name="type">Тип порта.</param>
    /// <param name="monitor">Монитор печати, на котором открыт порт.</param>
    /// <exception cref="ArgumentNullException"/>
    /// <exception cref="PrintingException"/>
    public Port(string name, string description, PortType type, IMonitor monitor) : this(name, description, type, monitor?.Name) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Port"/>.
    /// </summary>
    /// <param name="name">Наименование порта.</param>
    /// <param name="description">Описание порта.</param>
    /// <param name="type">Тип порта.</param>
    /// <exception cref="ArgumentNullException"/>
    /// <exception cref="PrintingException"/>
    public Port(string name, string description, PortType type) : this(name, description, type, null as string) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Port"/>.
    /// </summary>
    /// <param name="name">Наименование порта.</param>
    /// <param name="description">Описание порта.</param>
    /// <param name="monitorName">Наименование монитора печати, на котором открыт порт.</param>
    /// <exception cref="ArgumentNullException"/>
    /// <exception cref="PrintingException"/>
    public Port(string name, string description, string monitorName) : this(name, description, PortType.Redirected, monitorName) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Port"/>.
    /// </summary>
    /// <param name="name">Наименование порта.</param>
    /// <param name="description">Описание порта.</param>
    /// <param name="monitor">Монитор печати, на котором открыт порт.</param>
    /// <exception cref="ArgumentNullException"/>
    /// <exception cref="PrintingException"/>
    public Port(string name, string description, IMonitor monitor) : this(name, description, PortType.Redirected, monitor) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Port"/>.
    /// </summary>
    /// <param name="name">Наименование порта.</param>
    /// <param name="description">Описание порта.</param>
    /// <exception cref="ArgumentNullException"/>
    /// <exception cref="PrintingException"/>
    public Port(string name, string description) : this(name, description, null as string) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Port"/>.
    /// </summary>
    /// <param name="name">Наименование порта.</param>
    /// <param name="monitor">Монитор печати, на котором открыт порт.</param>
    /// <exception cref="ArgumentNullException"/>
    /// <exception cref="PrintingException"/>
    public Port(string name, IMonitor monitor) : this(name, null, monitor) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Port"/>.
    /// </summary>
    /// <param name="name">Наименование порта.</param>
    /// <param name="type">Тип порта.</param>
    /// <exception cref="ArgumentNullException"/>
    /// <exception cref="PrintingException"/>
    public Port(string name, PortType type) : this(name, null, type) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Port"/>.
    /// </summary>
    /// <param name="name">Наименование порта.</param>
    /// <exception cref="ArgumentNullException"/>
    /// <exception cref="PrintingException"/>
    public Port(string name) : this(name, null as string) { }

    /// <summary>
    /// Открывает порт на удалённой машине.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <exception cref="FileNotFoundException"/>
    /// <exception cref="PrintingException"/>
    public override void Install(string serverName)
    {
        try
        {
            if (All.Select(p => p.Name).Contains(Name)) Uninstall(serverName);

            PrinterDefaults defaults = new PrinterDefaults { DesiredAccess = PrinterAccess.ServerAdmin };

            if (!OpenPrinter($",XcvMonitor {Monitor.Name}", out IntPtr printerHandle, ref defaults)) throw new PrintingException(Marshal.GetLastWin32Error());

            PortData portData = new PortData
            {
                Version = 1,
                Protocol = DataType.RAW,
                PortNumber = 9100,  // 9100 = RAW, 515 = LPR.
                ReservedSize = 0,
                PortName = Name,
                IPAddress = serverName,
                SNMPCommunity = "public",
                SNMPEnabled = 1,
                SNMPDevIndex = 1,
            };

            uint size = (uint)Marshal.SizeOf(portData);
            portData.BufferSize = size;
            IntPtr pointer = Marshal.AllocHGlobal((int)size);
            Marshal.StructureToPtr(portData, pointer, true);

            try
            {
                IntPtr outputData = IntPtr.Zero;
                uint outputDataSize = 0;

                if (!XcvData(printerHandle, Enum.GetName(typeof(XcvDataType), XcvDataType.AddPort), pointer, size, outputData, outputDataSize, out uint outputNeeded, out uint status))
                    throw new PrintingException(Marshal.GetLastWin32Error());
            }
            catch (Exception e)
            {
                throw new PrintingException(e.Message, e);
            }
            finally
            {
                Marshal.FreeHGlobal(pointer);
                ClosePrinter(printerHandle);
            }
        }
        catch (Exception e)
        {
            throw new PrintingException(e.Message, e);
        }
    }

    /// <summary>
    /// Закрывает порт на удалённой машине.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <exception cref="FileNotFoundException"/>
    /// <exception cref="PrintingException"/>
    public override void Uninstall(string serverName)
    {
        try
        {
            if (!All.Select(p => p.Name).Contains(Name)) return;

            /// TODO: Удалить все принтеры, привязанные к порту.
                
            PrinterDefaults defaults = new PrinterDefaults { DesiredAccess = PrinterAccess.ServerAdmin };

            if (!OpenPrinter($",XcvPort {Name}", out IntPtr printerHandle, ref defaults)) throw new PrintingException(Marshal.GetLastWin32Error());

            PortData portData = new PortData
            {
                Version = 1,
                Protocol = DataType.RAW,
                PortNumber = 9100,
                ReservedSize = 0,
                PortName = Name,
                IPAddress = serverName,
                SNMPCommunity = "public",
                SNMPEnabled = 1,
                SNMPDevIndex = 1,
            };

            uint size = (uint)Marshal.SizeOf(portData);
            portData.BufferSize = size;
            IntPtr pointer = Marshal.AllocHGlobal((int)size);
            Marshal.StructureToPtr(portData, pointer, true);

            try
            {
                IntPtr outputData = IntPtr.Zero;
                uint outputDataSize = 0;

                if (!XcvData(printerHandle, Enum.GetName(typeof(XcvDataType), XcvDataType.DeletePort), pointer, size, outputData, outputDataSize, out uint outputNeeded, out uint status))
                    throw new PrintingException(Marshal.GetLastWin32Error());
            }
            catch (Exception e)
            {
                throw new PrintingException(e.Message, e);
            }
            finally
            {
                Marshal.FreeHGlobal(pointer);
                ClosePrinter(printerHandle);
            }
        }
        catch (Exception e)
        {
            throw new PrintingException(e.Message, e);
        }
    }

    #region Native
    /// <summary>
    /// Получает указатель на принтер.
    /// </summary>
    /// <param name="printerName">Имя принтера.</param>
    /// <param name="printer">Указатель на принтер.</param>
    /// <param name="printerDefaults">Установки для <see cref="XcvData(IntPtr, string, IntPtr, uint, IntPtr, uint, out uint, out uint)"/>.</param>
    /// <returns>True, если операция выполнена успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool OpenPrinter(string printerName, out IntPtr printer, ref PrinterDefaults printerDefaults);

    /// <summary>
    /// Освобождает ресурсы принтера.
    /// </summary>
    /// <param name="printer">Указатель принтера.</param>
    /// <returns>True, если операция выполнена успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool ClosePrinter(IntPtr printer);

    /// <summary>
    /// Производит оперции с принтером.
    /// </summary>
    /// <param name="printer">Указатель на принтер.</param>
    /// <param name="dataType">Тип операции.</param>
    /// <param name="inputData">Входные данные.</param>
    /// <param name="inputDataSize">Размер буфера входных данных.</param>
    /// <param name="outputData">Выходные данные.</param>
    /// <param name="outputDataSize">Размер буфера выходных данных.</param>
    /// <param name="outputNeeded">Размер указателя на выходные данные.</param>
    /// <param name="status">Статус операции.</param>
    /// <returns>True, если операция выполнена успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool XcvData(IntPtr printer, string dataType, IntPtr inputData, uint inputDataSize, IntPtr outputData, uint outputDataSize,
        out uint outputNeeded, out uint status);

    /// <summary>
    /// Возвращает указатель на буфер экземпляров структур <see cref="PortInfo"/>.
    /// </summary>
    /// <param name="serverName">Имя сервера, с которого требуется получить список портов. Если равно null - получает на локальной машине.</param>
    /// <param name="level">Номер версии структуры. Должен быть равен 1 или 2.</param>
    /// <param name="ports">Указатель на буфер экземпляров структур <see cref="PortInfo"/>.</param>
    /// <param name="bufferSize">Размер буфера экземпляров структур <see cref="PortInfo"/> (в байтах).</param>
    /// <param name="bytesNeeded">Число полученных байт размера буфера.</param>
    /// <param name="bufferReturnedLength">Число экземпляров структур.</param>
    /// <returns>True, если операция выполнена успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool EnumPorts(string serverName, uint level, IntPtr ports, uint bufferSize, ref uint bytesNeeded, ref uint bufferReturnedLength);
    #endregion
}

/// <summary>
/// Возвращает коллекцию всех октрытых портов печати в системе.
/// </summary>
public static Port[] Ports => Port.All;

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <param name="description">Описание порта.</param>
/// <param name="type">Тип порта.</param>
/// <param name="monitor">Монитор печати, на котором открывается порт.</param>
/// <param name="serverName">Имя сервера.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name, string description, PortType type, Monitor monitor, string serverName)
{
    Port port = new Port(name, description, type, monitor);
    monitor.TryInstall(serverName);

    return port;
}

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <param name="description">Описание порта.</param>
/// <param name="type">Тип порта.</param>
/// <param name="monitor">Монитор печати, на котором открывается порт.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name, string description, PortType type, Monitor monitor) => OpenPort(name, description, type, monitor, null);

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <param name="description">Описание порта.</param>
/// <param name="type">Тип порта.</param>
/// <param name="serverName">Имя сервера.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name, string description, PortType type, string serverName) => OpenPort(name, description, type, null, serverName);

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <param name="description">Описание порта.</param>
/// <param name="type">Тип порта.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name, string description, PortType type) => OpenPort(name, description, type, null as string);

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <param name="description">Описание порта.</param>
/// <param name="monitor">Монитор печати, на котором открывается порт.</param>
/// <param name="serverName">Имя сервера.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name, string description, Monitor monitor, string serverName)
    => OpenPort(name, description, PortType.Redirected, monitor, serverName);

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <param name="description">Описание порта.</param>
/// <param name="monitor">Монитор печати, на котором открывается порт.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name, string description, Monitor monitor) => OpenPort(name, description, monitor, null);

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <param name="monitor">Монитор печати, на котором открывается порт.</param>
/// <param name="serverName">Имя сервера.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name, Monitor monitor, string serverName)
    => OpenPort(name, null, monitor, serverName);

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <param name="monitor">Монитор печати, на котором открывается порт.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name, Monitor monitor) => OpenPort(name, monitor, null);

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <param name="type">Тип порта.</param>
/// <param name="serverName">Имя сервера.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name, PortType type, string serverName)
    => OpenPort(name, null, type, serverName);

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <param name="type">Тип порта.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name, PortType type) => OpenPort(name, type, null);

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <param name="description">Описание порта.</param>
/// <param name="serverName">Имя сервера.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name, string description, string serverName) => OpenPort(name, description, null, serverName);

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <param name="description">Описание порта.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name, string description) => OpenPort(name, description, null as string);

/// <summary>
/// Открывает новый порт печати в системе.
/// </summary>
/// <param name="name">Наименование порта.</param>
/// <returns>Экземпляр порта печати.</returns>
public Port OpenPort(string name) => OpenPort(name, null as string);

/// <summary>
/// Представляет тестовый модуль класса <see cref="Port"/>.
/// </summary>
[TestClass]
public class PortTests
{
    /// <summary>
    /// Наименование порта.
    /// </summary>
    protected const string PortName = "TESTPORT:";

    /// <summary>
    /// Описание порта.
    /// </summary>
    protected const string PortDescription = "Description for " + PortName;

    /// <summary>
    /// Наименование монитора.
    /// </summary>
    protected const string MonitorName = "mfilemon";

    /// <summary>
    /// Наименование несуществующего монитора.
    /// </summary>
    protected const string FailedMonitorName = "noexist";

    /// <summary>
    /// Тест локальной установки порта.
    /// </summary>
    [TestMethod]
    public void InstallTest()
    {
        Port port = new Port(PortName, PortDescription, MonitorName);
        port.Install();

        Assert.IsTrue(Port.All.Select(p => p.Name).Contains(PortName));
    }

    /// <summary>
    /// Тест локального удаления порта.
    /// </summary>
    [TestMethod]
    public void UninstallTest()
    {
        Port port = new Port(PortName, PortDescription, MonitorName);
        port.Uninstall();

        Assert.IsFalse(Port.All.Select(p => p.Name).Contains(PortName));
    }

    /// <summary>
    /// Тест локальной установки порта с перехватом состояния установки.
    /// </summary>
    [TestMethod]
    public void TryInstallTest()
    {
        Port port = new Port(PortName, PortDescription, MonitorName);
        bool f = port.TryInstall();

        Assert.IsTrue(f);
        Assert.IsTrue(Port.All.Select(p => p.Name).Contains(PortName));
    }

    /// <summary>
    /// Тест локального удаления порта с перехватом состояния удаления.
    /// </summary>
    [TestMethod]
    public void TryUninstallTest()
    {
        Port port = new Port(PortName, PortDescription, MonitorName);
        bool f = port.TryUninstall();

        Assert.IsTrue(f);
        Assert.IsFalse(Port.All.Select(p => p.Name).Contains(PortName));
    }

    /// <summary>
    /// Тест неправильной локальной установки порта.
    /// </summary>
    [TestMethod]
    [ExpectedException(typeof(PrintingException))]
    public void InstallFailedTest()
    {
        Port port = new Port(PortName, PortDescription, MonitorName);
        port.Install();

        Assert.IsFalse(Port.All.Select(p => p.Name).Contains(PortName));
    }

    /// <summary>
    /// Тест неправильной локальной установки порта с перехватом состояния установки.
    /// </summary>
    [TestMethod]
    public void TryInstallFailedTest()
    {
        Port port = new Port(PortName, PortDescription, FailedMonitorName);
        bool f = port.TryUninstall();

        Assert.IsTrue(f);
        Assert.IsFalse(Port.All.Select(p => p.Name).Contains(PortName));
    }
}

/// <summary>
/// Представляет структуру для хранения информации о драйвере устройства принтера.
/// </summary>
[StructLayout(LayoutKind.Sequential)]
public struct DriverInfo
{
    /// <summary>
    /// Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).
    /// </summary>
    public uint Version;

    /// <summary>
    /// Имя драйвера (например, "QMS 810").
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string Name;

    /// <summary>
    /// Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string Environment;

    /// <summary>
    /// Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string DriverPath;

    /// <summary>
    /// Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string DataFile;

    /// <summary>
    /// Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string ConfigFile;

    /// <summary>
    /// Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string HelpFile;

    /// <summary>
    /// Зависимые файлы.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string DependentFiles;

    /// <summary>
    /// Наименование монитора.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string MonitorName;

    /// <summary>
    /// Тип данных принтера по умолчанию.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string DefaultDataType;
}

/// <summary>
/// Представляет интерфейс для реализации сущностей драйверов печати.
/// </summary>
public interface IDriver : IPrintableDevice
{
    /// <summary>
    /// Монитор печати.
    /// </summary>
    IMonitor Monitor { get; }

    /// <summary>
    /// Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).
    /// </summary>
    uint Version { get; }

    /// <summary>
    /// Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).
    /// </summary>
    Environment Environment { get; }

    /// <summary>
    /// Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").
    /// </summary>
    string Dll { get; }

    /// <summary>
    /// Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").
    /// </summary>
    string DataFile { get; }

    /// <summary>
    /// Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").
    /// </summary>
    string ConfigFile { get; }

    /// <summary>
    /// Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").
    /// </summary>
    string HelpFile { get; }

    /// <summary>
    /// Зависимые файлы.
    /// </summary>
    string DependentFiles { get; }

    /// <summary>
    /// Тип данных принтера по умолчанию.
    /// </summary>
    DataType DefaultDataType { get; }
}

/// <summary>
/// Представляет данные для работы с драйвером печати.
/// </summary>
public class Driver : PrintableDevice, IDriver
{
    /// <summary>
    /// Монитор печати.
    /// </summary>
    public virtual IMonitor Monitor { get; protected set; }

    /// <summary>
    /// Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).
    /// </summary>
    public virtual uint Version { get; protected set; }

    /// <summary>
    /// Окружение, для которого был написан драйвер.
    /// </summary>
    public virtual Environment Environment { get; protected set; }

    /// <summary>
    /// Полный или относительный путь к файлу драйвера устройства.
    /// </summary>
    public virtual string Dll { get; protected set; }

    /// <summary>
    /// Полный или относительный путь к файлу данных драйвера.
    /// </summary>
    public virtual string DataFile { get; protected set; }

    /// <summary>
    /// Полный или относительный путь к dll данных конфигурации драйвера.
    /// </summary>
    public virtual string ConfigFile { get; protected set; }

    /// <summary>
    /// Полный или относительный путь к dll данных HLP-файла драйвера.
    /// </summary>
    public virtual string HelpFile { get; protected set; }

    /// <summary>
    /// Зависимые файлы.
    /// </summary>
    public virtual string DependentFiles { get; protected set; }
        
    /// <summary>
    /// Тип данных принтера по умолчанию.
    /// </summary>
    public virtual DataType DefaultDataType { get; protected set; }

    /// <summary>
    /// Путь к системному каталогу драйверов печати.
    /// </summary>
    public static string Directory { get; protected set; }

    /// <summary>
    /// Возвращает коллекцию всех установленных драйверов печати в системе.
    /// </summary>
    public static Driver[] All
    {
        get
        {
            if (!PrintingApi.TryGetInfo(EnumPrinterDrivers, 3, out DriverInfo[] driverInfo)) return null;

            Driver[] drivers = new Driver[driverInfo.Length];

            for (int i = 0; i < driverInfo.Length; i++)
                drivers[i] = new Driver(driverInfo[i].Name, driverInfo[i].DriverPath, driverInfo[i].DataFile, driverInfo[i].ConfigFile, driverInfo[i].HelpFile,
                    driverInfo[i].Version, driverInfo[i].Environment.GetEnvironment(), (DataType)Enum.Parse(typeof(DataType), driverInfo[i].DefaultDataType ?? "RAW", true),
                    driverInfo[i].DependentFiles, driverInfo[i].MonitorName);

            return drivers;
        }
    }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    /// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
    /// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
    /// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
    /// <param name="defaultDataType">Тип данных принтера по умолчанию.</param>
    /// <param name="dependentFiles">Зависимые файлы.</param>
    /// <param name="monitorName">Наименование монитора печати.</param>
    public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType,
        string dependentFiles, string monitorName) : base(name)
    {
        Dll = dll;
        DataFile = dataFile;
        ConfigFile = configFile;
        HelpFile = helpFile;
        Version = version;
        Environment = environment;
        DefaultDataType = defaultDataType;
        DependentFiles = dependentFiles;

        Monitor[] monitors = PrintingApi.Monitors;

        if (monitors.Select(m => m.Name).Contains(monitorName)) Monitor = monitors.Where(m => m.Name == monitorName).FirstOrDefault();
    }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    /// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
    /// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
    /// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
    /// <param name="defaultDataType">Тип данных принтера по умолчанию.</param>
    /// <param name="dependentFiles">Зависимые файлы.</param>
    /// <param name="monitor">Монитор печати.</param>
    public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType,
        string dependentFiles, IMonitor monitor)
        : this(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, dependentFiles, monitor?.Name) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    /// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
    /// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
    /// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
    /// <param name="defaultDataType">Тип данных принтера по умолчанию.</param>
    /// <param name="monitorName">Наименование монитора печати.</param>
    public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType,
        string monitorName)
        : this(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, null, monitorName) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    /// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
    /// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
    /// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
    /// <param name="defaultDataType">Тип данных принтера по умолчанию.</param>
    /// <param name="monitor">Монитор печати.</param>
    public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType,
        IMonitor monitor)
        : this(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, monitor?.Name) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    /// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
    /// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
    /// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
    /// <param name="monitorName">Наименование монитора печати.</param>
    public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, string monitorName)
        : this(name, dll, dataFile, configFile, helpFile, version, environment, DataType.RAW, monitorName) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    /// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
    /// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
    /// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
    /// <param name="monitor">Монитор печати.</param>
    public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, IMonitor monitor)
        : this(name, dll, dataFile, configFile, helpFile, version, environment, monitor?.Name) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    /// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
    /// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
    /// <param name="monitorName">Наименование монитора печати.</param>
    public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, string monitorName)
        : this(name, dll, dataFile, configFile, helpFile, version, Environment.Current, monitorName) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    /// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
    /// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
    /// <param name="monitor">Монитор печати.</param>
    public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, IMonitor monitor)
        : this(name, dll, dataFile, configFile, helpFile, version, monitor?.Name) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    /// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
    /// <param name="monitorName">Наименование монитора печати.</param>
    public Driver(string name, string dll, string dataFile, string configFile, string helpFile, string monitorName)
        : this(name, dll, dataFile, configFile, helpFile, 3, monitorName) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    /// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
    /// <param name="monitor">Монитор печати.</param>
    public Driver(string name, string dll, string dataFile, string configFile, string helpFile, IMonitor monitor)
        : this(name, dll, dataFile, configFile, helpFile, monitor?.Name) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    /// <param name="monitorName">Наименование монитора печати.</param>
    public Driver(string name, string dll, string dataFile, string configFile, string monitorName)
        : this(name, dll, dataFile, configFile, null, monitorName) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    /// <param name="monitor">Монитор печати.</param>
    public Driver(string name, string dll, string dataFile, string configFile, IMonitor monitor)
        : this(name, dll, dataFile, configFile, monitor?.Name) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Driver"/>.
    /// </summary>
    /// <param name="name">Наименование драйвера.</param>
    /// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
    /// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
    /// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
    public Driver(string name, string dll, string dataFile, string configFile)
        : this(name, dll, dataFile, configFile, null as string) { }

    /// <summary>
    /// Статический инициализатор класса <see cref="Driver"/>.
    /// </summary>
    static Driver()
    {
        uint length = 1024;
        StringBuilder driverDirectory = new StringBuilder((int)length);
        uint bytesNeeded = 0;

        if (!GetPrinterDriverDirectory(null, null, 1, driverDirectory, length, ref bytesNeeded)) throw new PrintingException(Marshal.GetLastWin32Error());

        Directory = driverDirectory.ToString();
    }

    /// <summary>
    /// Устанавливает драйвер удалённо в системе.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    public override void Install(string serverName)
    {
        try
        {
            if (!File.Exists(Dll)) throw new PrintingException($"Не удалось найти файл драйвера '{Dll}'");
            if (!File.Exists(DataFile)) throw new PrintingException($"Не удалось найти файл драйвера '{DataFile}'");
            if (!File.Exists(ConfigFile)) throw new PrintingException($"Не удалось найти файл драйвера '{ConfigFile}'");

            if (All.Select(d => d.Name).Contains(Name)) Uninstall(serverName);
                
            string systemDriverPath = Path.Combine(Directory, Path.GetFileName(Dll));
            string systemDataPath = Path.Combine(Directory, Path.GetFileName(DataFile));
            string systemConfigPath = Path.Combine(Directory, Path.GetFileName(ConfigFile));
            string systemHelpPath = Path.Combine(Directory, Path.GetFileName(HelpFile));

            File.Copy(Dll, systemDriverPath, true);
            File.Copy(DataFile, systemDataPath, true);
            File.Copy(ConfigFile, systemConfigPath, true);
                
            if (File.Exists(HelpFile)) File.Copy(HelpFile, systemHelpPath, true);

            DriverInfo driverInfo = new DriverInfo
            {
                Version = Version,
                Name = Name,
                Environment = Environment.GetEnvironmentName(),
                DriverPath = File.Exists(systemDriverPath) ? systemDriverPath : Dll,
                DataFile = File.Exists(systemDataPath) ? systemDataPath : DataFile,
                ConfigFile = File.Exists(systemConfigPath) ? systemConfigPath : ConfigFile,
                HelpFile = File.Exists(systemHelpPath) ? systemHelpPath : HelpFile,
                DependentFiles = DependentFiles,
                MonitorName = Monitor?.Name,
                DefaultDataType = Enum.GetName(typeof(DataType), DefaultDataType),
            };

            if (AddPrinterDriver(serverName, Version, ref driverInfo)) return;

            int lastWin32ErrorCode = Marshal.GetLastWin32Error();

            if (lastWin32ErrorCode == 0) return;

            throw new PrintingException(lastWin32ErrorCode);
        }
        catch (Exception e)
        {
            throw new PrintingException(e.Message, e);
        }
    }

    /// <summary>
    /// Удаляет драйвер удалённо в системе.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    public override void Uninstall(string serverName)
    {
        try
        {
            if (!All.Select(d => d.Name).Contains(Name)) return;

            /// TODO: Удалить все принтеры, использующие драйвер.

            if (DeletePrinterDriver(serverName, Environment.GetEnvironmentName(), Name)) return;

            throw new PrintingException(Marshal.GetLastWin32Error());
        }
        catch (Exception e)
        {
            throw new PrintingException(e.Message, e);
        }
    }

    #region Native
    /// <summary>
    /// Возвращает путь к системной директории с установленными драйверами принтера.
    /// </summary>
    /// <param name="serverName">Имя сервера, с которого требуется получить путь к директории драйвера принтера. Если равно null - получает локальный путь.</param>
    /// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
    /// <param name="level">Номер версии структуры. Должен быть равен 1.</param>
    /// <param name="driverDirectory">Путь к драйверу принтера.</param>
    /// <param name="bufferSize">Размер буфера для вывода пути.</param>
    /// <param name="bytesNeeded">Число полученных байт пути.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool GetPrinterDriverDirectory(string serverName, string environment, uint level, [Out] StringBuilder driverDirectory, uint bufferSize,
        ref uint bytesNeeded);

    /// <summary>
    /// Добавляет драйвер в систему.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="level">Номер версии структуры. Должен быть равен 1, 2, 3, 4, 5, 6 или 8.</param>
    /// <param name="driverInfo">Данные драйвера.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool AddPrinterDriver(string serverName, uint level, ref DriverInfo driverInfo);

    /// <summary>
    /// Возвращает указатель на буфер экземпляров структур <see cref="DriverInfo"/>.
    /// </summary>
    /// <param name="serverName">Имя сервера, с которого требуется получить список портов. Если равно null - получает на локальной машине.</param>
    /// <param name="environment">Окружение (например, Windows x86, Windows IA64, Windows x64, или Windows NT R4000). Если параметр равен null,
    /// используется вызываемое окружение клиента (не сервера). Если параметр равен "all", метод верёт список драйверов для всех платформ,
    /// для которых они были установлены на сервере.</param>
    /// <param name="level">Номер версии структуры. Должен быть равен 1, 2, 3, 4, 5, 6 или 8.</param>
    /// <param name="drivers">Указатель на буфер экземпляров структур <see cref="DriverInfo"/>.</param>
    /// <param name="bufferSize">Размер буфера экземпляров структур <see cref="DriverInfo"/> (в байтах).</param>
    /// <param name="bytesNeeded">Число полученных байт размера буфера.</param>
    /// <param name="bufferReturnedLength">Число экземпляров структур.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool EnumPrinterDrivers(string serverName, string environment, uint level, IntPtr drivers, uint bufferSize, ref uint bytesNeeded,
        ref uint bufferReturnedLength);

    /// <summary>
    /// Удаляет драйвер из системы.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="environment">Окружение (например, Windows x86, Windows IA64, Windows x64, или Windows NT R4000). Если параметр равен null,
    /// используется вызываемое окружение клиента (не сервера). Если параметр равен "all", метод верёт список драйверов для всех платформ,
    /// для которых они были установлены на сервере.</param>
    /// <param name="driverName">Наименование драйвера.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool DeletePrinterDriver(string serverName, string environment, string driverName);
    #endregion
}

/// <summary>
/// Возвращает коллекцию всех установленных драйверов печати в системе.
/// </summary>
public static Driver[] Drivers => Driver.All;

/// <summary>
/// Устанавливает новый драйвер в системе.
/// </summary>
/// <param name="name">Наименование драйвера.</param>
/// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
/// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
/// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
/// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
/// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
/// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
/// <param name="defaultDataType">Тип данных принтера по умолчанию.</param>
/// <param name="dependentFiles">Зависимые файлы.</param>
/// <param name="monitor">Монитор печати.</param>
/// <param name="serverName">Имя сервера.</param>
/// <returns>Экземпляр драйвера печати.</returns>
public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment,
    DataType defaultDataType, string dependentFiles, Monitor monitor, string serverName)
{
    Driver driver = new Driver(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, dependentFiles, monitor);
    driver.TryInstall(serverName);

    return driver;
}

/// <summary>
/// Устанавливает новый драйвер в системе.
/// </summary>
/// <param name="name">Наименование драйвера.</param>
/// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
/// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
/// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
/// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
/// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
/// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
/// <param name="defaultDataType">Тип данных принтера по умолчанию.</param>
/// <param name="dependentFiles">Зависимые файлы.</param>
/// <param name="monitor">Монитор печати.</param>
/// <returns>Экземпляр драйвера печати.</returns>
public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment,
    DataType defaultDataType, string dependentFiles, Monitor monitor)
    => InstallDriver(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, dependentFiles, monitor, null);

/// <summary>
/// Устанавливает новый драйвер в системе.
/// </summary>
/// <param name="name">Наименование драйвера.</param>
/// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
/// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
/// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
/// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
/// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
/// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
/// <param name="defaultDataType">Тип данных принтера по умолчанию.</param>
/// <param name="dependentFiles">Зависимые файлы.</param>
/// <param name="serverName">Имя сервера.</param>
/// <returns>Экземпляр драйвера печати.</returns>
public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment,
    DataType defaultDataType, string dependentFiles, string serverName)
    => InstallDriver(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, dependentFiles, null, serverName);

/// <summary>
/// Устанавливает новый драйвер в системе.
/// </summary>
/// <param name="name">Наименование драйвера.</param>
/// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
/// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
/// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
/// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
/// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
/// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
/// <param name="defaultDataType">Тип данных принтера по умолчанию.</param>
/// <param name="dependentFiles">Зависимые файлы.</param>
/// <returns>Экземпляр драйвера печати.</returns>
public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment,
    DataType defaultDataType, string dependentFiles)
    => InstallDriver(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, dependentFiles, null as string);

/// <summary>
/// Устанавливает новый драйвер в системе.
/// </summary>
/// <param name="name">Наименование драйвера.</param>
/// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
/// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
/// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
/// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
/// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
/// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
/// <param name="defaultDataType">Тип данных принтера по умолчанию.</param>
/// <returns>Экземпляр драйвера печати.</returns>
public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment,
    DataType defaultDataType)
    => InstallDriver(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, null);

/// <summary>
/// Устанавливает новый драйвер в системе.
/// </summary>
/// <param name="name">Наименование драйвера.</param>
/// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
/// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
/// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
/// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
/// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
/// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
/// <param name="serverName">Имя сервера.</param>
/// <returns>Экземпляр драйвера печати.</returns>
public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment,
    string serverName)
    => InstallDriver(name, dll, dataFile, configFile, helpFile, version, environment, DataType.RAW, serverName);

/// <summary>
/// Устанавливает новый драйвер в системе.
/// </summary>
/// <param name="name">Наименование драйвера.</param>
/// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
/// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
/// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
/// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
/// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
/// <param name="environment">Окружение, для которого был написан драйвер (например, Windows x86, Windows IA64 или Windows x64).</param>
/// <returns>Экземпляр драйвера печати.</returns>
public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment)
    => InstallDriver(name, dll, dataFile, configFile, helpFile, version, environment, null);

/// <summary>
/// Устанавливает новый драйвер в системе.
/// </summary>
/// <param name="name">Наименование драйвера.</param>
/// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
/// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
/// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
/// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
/// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
/// <param name="serverName">Имя сервера.</param>
/// <returns>Экземпляр драйвера печати.</returns>
public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, string serverName)
    => InstallDriver(name, dll, dataFile, configFile, helpFile, version, Environment.Current, serverName);

/// <summary>
/// Устанавливает новый драйвер в системе.
/// </summary>
/// <param name="name">Наименование драйвера.</param>
/// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
/// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
/// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
/// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
/// <param name="version">Номер версии операционной системы, для которой был написан драйвер. Поддерживаемые значения - 3 и 4 (V3 и V4 номера версий драйвера соответственно).</param>
/// <returns>Экземпляр драйвера печати.</returns>
public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version)
    => InstallDriver(name, dll, dataFile, configFile, helpFile, version, null);

/// <summary>
/// Устанавливает новый драйвер в системе.
/// </summary>
/// <param name="name">Наименование драйвера.</param>
/// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
/// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
/// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
/// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
/// <param name="serverName">Имя сервера.</param>
/// <returns>Экземпляр драйвера печати.</returns>
public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, string serverName)
    => InstallDriver(name, dll, dataFile, configFile, helpFile, 3, serverName);

/// <summary>
/// Устанавливает новый драйвер в системе.
/// </summary>
/// <param name="name">Наименование драйвера.</param>
/// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
/// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
/// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
/// <param name="helpFile">Полный или относительный путь к dll данных HLP-файла драйвера (например, "C:DRIVERSPscript.hlp").</param>
/// <returns>Экземпляр драйвера печати.</returns>
public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile)
    => InstallDriver(name, dll, dataFile, configFile, helpFile, null);

/// <summary>
/// Устанавливает новый драйвер в системе.
/// </summary>
/// <param name="name">Наименование драйвера.</param>
/// <param name="dll">Полный или относительный путь к файлу драйвера устройства (например, "C:DRIVERSPscript.dll").</param>
/// <param name="dataFile">Полный или относительный путь к файлу данных драйвера (например, "C:DRIVERSQms810.ppd").</param>
/// <param name="configFile">Полный или относительный путь к dll данных конфигурации драйвера (например, "C:DRIVERSPscriptui.dll").</param>
/// <returns>Экземпляр драйвера печати.</returns>
public Driver InstallDriver(string name, string dll, string dataFile, string configFile) => InstallDriver(name, dll, dataFile, configFile, null);

IEnumerable<Driver> drivers = Driver.All.Where(d => d.Monitor?.Name == Name);
foreach (Driver driver in drivers) driver.Uninstall(serverName);

/// <summary>
/// Представляет тестовый модуль класса <see cref="Driver"/>.
/// </summary>
[TestClass]
public class DriverTests
{
    /// <summary>
    /// Наименование драйвера.
    /// </summary>
    protected const string DriverName = "Test Driver";

    /// <summary>
    /// Наименование монитора.
    /// </summary>
    protected const string MonitorName = "mfilemon";

    /// <summary>
    /// Наименование несуществующего монитора.
    /// </summary>
    protected const string FailedMonitorName = "noexist";

    protected const string DllPath = "D:/Printing Tests/pscript.dll";
    protected const string DataPath = "D:/Printing Tests/testprinter.ppd";
    protected const string ConfigPath = "D:/Printing Tests/pscriptui.dll";
    protected const string HelpPath = "D:/Printing Tests/pscript.hlp";

    /// <summary>
    /// Тест локальной установки драйвера.
    /// </summary>
    [TestMethod]
    public void InstallTest()
    {
        Driver driver = new Driver(DriverName, DllPath, DataPath, ConfigPath, HelpPath, MonitorName);
        driver.Install();

        Assert.IsTrue(Driver.All.Select(d => d.Name).Contains(DriverName));
    }

    /// <summary>
    /// Тест локального удаления драйвера.
    /// </summary>
    [TestMethod]
    public void UninstallTest()
    {
        Driver driver = new Driver(DriverName, DllPath, DataPath, ConfigPath, HelpPath, MonitorName);
        driver.Uninstall();

        Assert.IsFalse(Driver.All.Select(d => d.Name).Contains(DriverName));
    }

    /// <summary>
    /// Тест локальной установки драйвера с перехватом состояния установки.
    /// </summary>
    [TestMethod]
    public void TryInstallTest()
    {
        Driver driver = new Driver(DriverName, DllPath, DataPath, ConfigPath, HelpPath, MonitorName);
        bool f = driver.TryInstall();

        Assert.IsTrue(f);
        Assert.IsTrue(Driver.All.Select(d => d.Name).Contains(DriverName));
    }

    /// <summary>
    /// Тест локального удаления драйвера с перехватом состояния удаления.
    /// </summary>
    [TestMethod]
    public void TryUninstallTest()
    {
        Driver driver = new Driver(DriverName, DllPath, DataPath, ConfigPath, HelpPath, MonitorName);
        bool f = driver.TryUninstall();

        Assert.IsTrue(f);
        Assert.IsFalse(Driver.All.Select(d => d.Name).Contains(DriverName));
    }

    /// <summary>
    /// Тест неправильной локальной установки драйвера.
    /// </summary>
    [TestMethod]
    [ExpectedException(typeof(PrintingException))]
    public void InstallFailedTest()
    {
        Driver driver = new Driver(DriverName, DllPath + "failed", DataPath, ConfigPath, HelpPath, FailedMonitorName);
        driver.Install();

        Assert.IsFalse(Driver.All.Select(d => d.Name).Contains(DriverName));
    }

    /// <summary>
    /// Тест неправильной локальной установки драйвера с перехватом состояния установки.
    /// </summary>
    [TestMethod]
    public void TryInstallFailedTest()
    {
        Driver driver = new Driver(DriverName, DllPath + "failed", DataPath, ConfigPath, HelpPath, FailedMonitorName);
        bool f = driver.TryInstall();

        Assert.IsTrue(f);
        Assert.IsFalse(Driver.All.Select(d => d.Name).Contains(DriverName));
    }
}

/// <summary>
/// Представляет структуру данных принтера.
/// </summary>
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)]
public struct PrinterInfo
{
    /// <summary>
    /// Имя сервера.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string ServerName;

    /// <summary>
    /// Наименование принтера.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string PrinterName;

    /// <summary>
    /// Публичное наименование принтера.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string ShareName;

    /// <summary>
    /// Наименование порта, привязанного к принтеру.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string PortName;

    /// <summary>
    /// Наименование драйвера принтера.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string DriverName;

    /// <summary>
    /// Описание принтера.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string Comment;

    /// <summary>
    /// Местоположение принтера.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string Location;

    public IntPtr DevMode;

    [MarshalAs(UnmanagedType.LPTStr)]
    public string SepFile;

    /// <summary>
    /// Процессор печати, связанный с принтером.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string PrintProcessor;

    /// <summary>
    /// Тип данных печати принтера.
    /// </summary>
    [MarshalAs(UnmanagedType.LPTStr)]
    public string DataType;

    [MarshalAs(UnmanagedType.LPTStr)]
    public string Parameters;

    public IntPtr SecurityDescriptor;

    public uint Attributes;
    public uint Priority;
    public uint DefaultPriority;
    public uint StartTime;
    public uint UntilTime;
    public uint Status;
    public uint cJobs;
    public uint AveragePPM;
}

/// <summary>
/// Флаги выборки принтеров при получении их списка.
/// </summary>
[Flags]
internal enum PrinterEnumFlag
{
    Default = 0x00000001,
    Local = 0x00000002,
    Connections = 0x00000004,
    Favorite = 0x00000004,
    Name = 0x00000008,
    Remote = 0x00000010,
    Shared = 0x00000020,
    Network = 0x00000040,
    Expand = 0x00004000,
    Container = 0x00008000,
    IconMask = 0x00ff0000,
    Icon1 = 0x00010000,
    Icon2 = 0x00020000,
    Icon3 = 0x00040000,
    Icon4 = 0x00080000,
    Icon5 = 0x00100000,
    Icon6 = 0x00200000,
    Icon7 = 0x00400000,
    Icon8 = 0x00800000,
    Hide = 0x01000000,
    All = 0x02000000,
    Category3D = 0x04000000,
}

/// <summary>
/// Представляет интерфейс для реализации принтеров.
/// </summary>
public interface IPrinter : IPrintableDevice
{
    /// <summary>
    /// Порт, к которому привязан принтер.
    /// </summary>
    IPort Port { get; }

    /// <summary>
    /// Драйвер, который связан с принтером.
    /// </summary>
    IDriver Driver { get; }

    /// <summary>
    /// Публичное наименование принтера.
    /// </summary>
    string ShareName { get; }

    /// <summary>
    /// Имя сервера, на котором запущен принтер.
    /// </summary>
    string ServerName { get; }

    /// <summary>
    /// Описание устройства принтера.
    /// </summary>
    string Description { get; }

    /// <summary>
    /// Расположение принтера.
    /// </summary>
    string Location { get; }
        
    string SepFile { get; }

    /// <summary>
    /// Параметры принтера.
    /// </summary>
    string Parameters { get; }

    /// <summary>
    /// Тип данных печати.
    /// </summary>
    DataType DataType { get; }
}

/// <summary>
/// Представляет устройство принтера.
/// </summary>
public class Printer : PrintableDevice, IPrinter
{
    /// <summary>
    /// Порт, к которому привязан принтер.
    /// </summary>
    public virtual IPort Port { get; protected set; }

    /// <summary>
    /// Драйвер, который связан с принтером.
    /// </summary>
    public virtual IDriver Driver { get; protected set; }

    /// <summary>
    /// Публичное наименование принтера.
    /// </summary>
    public virtual string ShareName { get; protected set; }

    /// <summary>
    /// Описание устройства принтера.
    /// </summary>
    public virtual string Description { get; protected set; }

    /// <summary>
    /// Тип данных печати.
    /// </summary>
    public virtual DataType DataType { get; protected set; }

    /// <summary>
    /// Процессор очереди печати.
    /// </summary>
    public virtual string Processor { get; protected set; }

    /// <summary>
    /// Имя сервера, на котором запущен принтер.
    /// </summary>
    public virtual string ServerName { get; protected set; }

    /// <summary>
    /// Расположение принтера.
    /// </summary>
    public virtual string Location { get; protected set; }

    /// <summary>
    /// Параметры принтера.
    /// </summary>
    public virtual string Parameters { get; protected set; }

    public virtual string SepFile { get; protected set; }

    /// <summary>
    /// Задаёт или возвращает принтер по умолчанию.
    /// </summary>
    public static Printer Default
    {
        get
        {
            uint length = 0;

            if (GetDefaultPrinter(null, ref length)) return null;

            int lastWin32Error = Marshal.GetLastWin32Error();

            if (lastWin32Error != PrintingException.ErrorInsufficientBuffer) throw new PrintingException(lastWin32Error);

            StringBuilder printerName = new StringBuilder((int)length);

            if (!GetDefaultPrinter(printerName, ref length)) throw new PrintingException(Marshal.GetLastWin32Error());

            string name = printerName.ToString();

            return All.Where(p => p.Name == name).FirstOrDefault();
        }

        set
        {
            if (!SetDefaultPrinter(value?.Name)) throw new PrintingException(Marshal.GetLastWin32Error());
        }
    }

    /// <summary>
    /// Список всех установленных принтеров в системе.
    /// </summary>
    public static Printer[] All
    {
        get
        {
            uint bytesNeeded = 0;
            uint bufferReturnedLength = 0;
            uint level = 2;
            PrinterEnumFlag flags = PrinterEnumFlag.Local | PrinterEnumFlag.Network;

            if (EnumPrinters(flags, null, level, IntPtr.Zero, 0, ref bytesNeeded, ref bufferReturnedLength)) return null;

            int lastWin32Error = Marshal.GetLastWin32Error();

            if (lastWin32Error != PrintingException.ErrorInsufficientBuffer) throw new PrintingException(lastWin32Error);

            IntPtr printersPtr = Marshal.AllocHGlobal((int)bytesNeeded);

            try
            {
                if (EnumPrinters(flags, null, level, printersPtr, bytesNeeded, ref bytesNeeded, ref bufferReturnedLength))
                {
                    IntPtr currentPrinterPtr = printersPtr;
                    PrinterInfo[] printerInfo = new PrinterInfo[bufferReturnedLength];
                    Printer[] printers = new Printer[bufferReturnedLength];
                    Type type = typeof(PrinterInfo);

                    for (int i = 0; i < bufferReturnedLength; i++)
                    {
                        printerInfo[i] = (PrinterInfo)Marshal.PtrToStructure(currentPrinterPtr, type);
                        currentPrinterPtr = (IntPtr)(currentPrinterPtr.ToInt64() + Marshal.SizeOf(type));

                        printers[i] = new Printer(printerInfo[i].PrinterName, printerInfo[i].PortName, printerInfo[i].DriverName, printerInfo[i].PrintProcessor,
                            printerInfo[i].ShareName, printerInfo[i].ServerName, printerInfo[i].Comment,
                            (DataType)Enum.Parse(typeof(DataType), printerInfo[i].DataType), printerInfo[i].Location, printerInfo[i].Parameters,
                            printerInfo[i].SepFile);
                    }

                    return printers;
                }

                throw new PrintingException(Marshal.GetLastWin32Error());
            }
            catch
            {
                return null;
            }
            finally
            {
                Marshal.FreeHGlobal(printersPtr);
            }
        }
    }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="portName">Наименование порта.</param>
    /// <param name="driverName">Наименование драйвера.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="description">Описание принтера.</param>
    /// <param name="dataType">Тип данных печати.</param>
    /// <param name="location">Местоположение принтера.</param>
    /// <param name="parameters">Параметры принтера.</param>
    /// <param name="sepFile"></param>
    public Printer(string name, string portName, string driverName, string processorName, string shareName, string serverName, string description, DataType dataType,
        string location, string parameters, string sepFile) : base(name)
    {
        Port[] ports = PrintingApi.Ports;
        Driver[] drivers = PrintingApi.Drivers;

        if (ports.Select(p => p.Name).Contains(portName)) Port = ports.Where(p => p.Name == portName).FirstOrDefault();
        if (drivers.Select(d => d.Name).Contains(driverName)) Driver = drivers.Where(d => d.Name == driverName).FirstOrDefault();

        Processor = processorName;
        ShareName = shareName;
        ServerName = serverName;
        Description = description;
        DataType = dataType;
        Location = location;
        Parameters = parameters;
        SepFile = sepFile;
    }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="port">Порт, к которому привязан принтер.</param>
    /// <param name="driver">Драйвер, который связан с принтером.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="description">Описание принтера.</param>
    /// <param name="dataType">Тип данных печати.</param>
    /// <param name="location">Местоположение принтера.</param>
    /// <param name="parameters">Параметры принтера.</param>
    /// <param name="sepFile"></param>
    public Printer(string name, IPort port, IDriver driver, string processorName, string shareName, string serverName, string description, DataType dataType,
        string location, string parameters, string sepFile)
        : this(name, port?.Name, driver?.Name, processorName, shareName, serverName, description, dataType, location, parameters, sepFile) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="portName">Наименование порта.</param>
    /// <param name="driverName">Наименование драйвера.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="description">Описание принтера.</param>
    /// <param name="dataType">Тип данных печати.</param>
    /// <param name="location">Местоположение принтера.</param>
    /// <param name="parameters">Параметры принтера.</param>
    public Printer(string name, string portName, string driverName, string processorName, string shareName, string serverName, string description, DataType dataType,
        string location, string parameters)
        : this(name, portName, driverName, processorName, shareName, serverName, description, dataType, location, parameters, null) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="port">Порт, к которому привязан принтер.</param>
    /// <param name="driver">Драйвер, который связан с принтером.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="description">Описание принтера.</param>
    /// <param name="dataType">Тип данных печати.</param>
    /// <param name="location">Местоположение принтера.</param>
    /// <param name="parameters">Параметры принтера.</param>
    public Printer(string name, IPort port, IDriver driver, string processorName, string shareName, string serverName, string description, DataType dataType,
        string location, string parameters)
        : this(name, port?.Name, driver?.Name, processorName, shareName, serverName, description, dataType, location, parameters) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="portName">Наименование порта.</param>
    /// <param name="driverName">Наименование драйвера.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="description">Описание принтера.</param>
    /// <param name="dataType">Тип данных печати.</param>
    /// <param name="location">Местоположение принтера.</param>
    public Printer(string name, string portName, string driverName, string processorName, string shareName, string serverName, string description, DataType dataType,
        string location)
        : this(name, portName, driverName, processorName, shareName, serverName, description, dataType, location, null) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="port">Порт, к которому привязан принтер.</param>
    /// <param name="driver">Драйвер, который связан с принтером.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="description">Описание принтера.</param>
    /// <param name="dataType">Тип данных печати.</param>
    /// <param name="location">Местоположение принтера.</param>
    public Printer(string name, IPort port, IDriver driver, string processorName, string shareName, string serverName, string description, DataType dataType,
        string location)
        : this(name, port?.Name, driver?.Name, processorName, shareName, serverName, description, dataType, location) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="portName">Наименование порта.</param>
    /// <param name="driverName">Наименование драйвера.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="description">Описание принтера.</param>
    /// <param name="dataType">Тип данных печати.</param>
    public Printer(string name, string portName, string driverName, string processorName, string shareName, string serverName, string description, DataType dataType)
        : this(name, portName, driverName, processorName, shareName, serverName, description, dataType, null) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="port">Порт, к которому привязан принтер.</param>
    /// <param name="driver">Драйвер, который связан с принтером.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="description">Описание принтера.</param>
    /// <param name="dataType">Тип данных печати.</param>
    public Printer(string name, IPort port, IDriver driver, string processorName, string shareName, string serverName, string description, DataType dataType)
        : this(name, port?.Name, driver?.Name, processorName, shareName, serverName, description, dataType) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="portName">Наименование порта.</param>
    /// <param name="driverName">Наименование драйвера.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="description">Описание принтера.</param>
    public Printer(string name, string portName, string driverName, string processorName, string shareName, string serverName, string description)
        : this(name, portName, driverName, processorName, shareName, serverName, description, DataType.RAW) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="port">Порт, к которому привязан принтер.</param>
    /// <param name="driver">Драйвер, который связан с принтером.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="description">Описание принтера.</param>
    public Printer(string name, IPort port, IDriver driver, string processorName, string shareName, string serverName, string description)
        : this(name, port?.Name, driver?.Name, processorName, shareName, serverName, description) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="portName">Наименование порта.</param>
    /// <param name="driverName">Наименование драйвера.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    /// <param name="serverName">Имя сервера.</param>
    public Printer(string name, string portName, string driverName, string processorName, string shareName, string serverName)
        : this(name, portName, driverName, processorName, shareName, serverName, null) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="port">Порт, к которому привязан принтер.</param>
    /// <param name="driver">Драйвер, который связан с принтером.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    /// <param name="serverName">Имя сервера.</param>
    public Printer(string name, IPort port, IDriver driver, string processorName, string shareName, string serverName)
        : this(name, port?.Name, driver?.Name, processorName, shareName, serverName) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="portName">Наименование порта.</param>
    /// <param name="driverName">Наименование драйвера.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    public Printer(string name, string portName, string driverName, string processorName, string shareName)
        : this(name, portName, driverName, processorName, shareName, null) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="port">Порт, к которому привязан принтер.</param>
    /// <param name="driver">Драйвер, который связан с принтером.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    /// <param name="shareName">Публичное наименование принтера.</param>
    public Printer(string name, IPort port, IDriver driver, string processorName, string shareName) : this(name, port?.Name, driver?.Name, processorName, shareName)
    { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="portName">Наименование порта.</param>
    /// <param name="driverName">Наименование драйвера.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    public Printer(string name, string portName, string driverName, string processorName) : this(name, portName, driverName, processorName, null) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="port">Порт, к которому привязан принтер.</param>
    /// <param name="driver">Драйвер, который связан с принтером.</param>
    /// <param name="processorName">Наименование процессора печати.</param>
    public Printer(string name, IPort port, IDriver driver, string processorName) : this(name, port?.Name, driver?.Name, processorName) { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="portName">Наименование порта.</param>
    /// <param name="driverName">Наименование драйвера.</param>
    public Printer(string name, string portName, string driverName) : this(name, portName, driverName, "WinPrint") { }

    /// <summary>
    /// Инициализирует новый экземпляр класса <see cref="Printer"/>.
    /// </summary>
    /// <param name="name">Наименование принтера.</param>
    /// <param name="port">Порт, к которому привязан принтер.</param>
    /// <param name="driver">Драйвер, который связан с принтером.</param>
    public Printer(string name, IPort port, IDriver driver) : this(name, port?.Name, driver?.Name) { }

    /// <summary>
    /// Устанавливает принтер в системе.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    public override void Install(string serverName)
    {
        try
        {
            if (All.Select(p => p.Name).Contains(Name)) Uninstall(serverName);

            PrinterInfo printerInfo = new PrinterInfo
            {
                ServerName = serverName,
                PrinterName = Name,
                ShareName = ShareName,
                PortName = Port?.Name,
                DriverName = Driver?.Name,
                Comment = Description,
                Location = Location,
                DevMode = new IntPtr(0),
                SepFile = SepFile,
                PrintProcessor = Processor,
                DataType = Enum.GetName(typeof(DataType), DataType),
                Parameters = Parameters,
                SecurityDescriptor = new IntPtr(0),
            };

            if (AddPrinter(serverName, 2, ref printerInfo)) return;

            int lastWin32ErrorCode = Marshal.GetLastWin32Error();

            if (lastWin32ErrorCode == 0) return;

            throw new PrintingException(lastWin32ErrorCode);
        }
        catch (Exception e)
        {
            throw new PrintingException(e.Message, e);
        }
    }

    /// <summary>
    /// Удаляет принтер из системы.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    public override void Uninstall(string serverName)
    {
        try
        {
            if (!All.Select(p => p.Name).Contains(Name)) return;

            PrinterDefaults defaults = new PrinterDefaults { DesiredAccess = PrinterAccess.PrinterAllAccess };

            if (!NET.Port.OpenPrinter(Name, out IntPtr printerHandle, ref defaults)) throw new PrintingException(Marshal.GetLastWin32Error());

            if (!DeletePrinter(printerHandle))
            {
                int lastWin32ErrorCode = Marshal.GetLastWin32Error();

                if (lastWin32ErrorCode == PrintingException.ErrorInvalidPrinterName) return;

                throw new PrintingException(lastWin32ErrorCode);
            }

            NET.Port.ClosePrinter(printerHandle);
        }
        catch (Exception e)
        {
            throw new PrintingException(e.Message, e);
        }
    }

    #region Native
    /// <summary>
    /// Устанавливает принтер в системе.
    /// </summary>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <param name="printerInfo">Структура данных.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true, CallingConvention = CallingConvention.StdCall)]
    internal static extern bool AddPrinter(string serverName, uint level, [In] ref PrinterInfo printerInfo);

    /// <summary>
    /// Возвращает имя принтера, установленного в системе по умолчанию.
    /// </summary>
    /// <param name="printerName">Имя принтера.</param>
    /// <param name="bytesNeeded">Размер символьного буфера имени.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool GetDefaultPrinter([Out] StringBuilder printerName, ref uint bytesNeeded);

    /// <summary>
    /// Устанавливает имя принтера по умолчанию.
    /// </summary>
    /// <param name="printerName">Имя устанавливаемого по умолчанию принтера.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool SetDefaultPrinter(string printerName);

    /// <summary>
    /// Получает список установленных в системе принтеров.
    /// </summary>
    /// <param name="flags">Флаги для выборки результатов.</param>
    /// <param name="serverName">Имя сервера.</param>
    /// <param name="level">Уровень структуры.</param>
    /// <param name="printers">Указатель на буфер структур.</param>
    /// <param name="bufferSize">Размер буфера.</param>
    /// <param name="bytesNeeded">Число требуемых байт для выделения памяти под буфер.</param>
    /// <param name="bufferReturnedLength">Размер полученного буфера.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern bool EnumPrinters(PrinterEnumFlag flags, string serverName, uint level, IntPtr printers, uint bufferSize, ref uint bytesNeeded,
        ref uint bufferReturnedLength);

    /// <summary>
    /// Удаляет принтер из системы.
    /// </summary>
    /// <param name="printer">Указатель на принтер.</param>
    /// <returns>True, если операция прошла успешно, иначе False.</returns>
    [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true, CallingConvention = CallingConvention.StdCall)]
    internal static extern bool DeletePrinter(IntPtr printer);
    #endregion
}

/// <summary>
/// Возвращает коллекцию всех установленных устройств печати в системе.
/// </summary>
public static Printer[] Printers => Printer.All;

/// <summary>
/// Инициализирует новый экземпляр класса <see cref="Printer"/>.
/// </summary>
/// <param name="name">Наименование принтера.</param>
/// <param name="port">Порт, к которому привязан принтер.</param>
/// <param name="driver">Драйвер, который связан с принтером.</param>
/// <param name="processorName">Наименование процессора печати.</param>
/// <param name="shareName">Публичное наименование принтера.</param>
/// <param name="serverName">Имя сервера.</param>
/// <param name="description">Описание принтера.</param>
/// <param name="dataType">Тип данных печати.</param>
/// <param name="location">Местоположение принтера.</param>
/// <param name="parameters">Параметры принтера.</param>
/// <param name="sepFile"></param>
/// <returns>Экземпляр устройства печати.</returns>
public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName, string serverName, string description,
    DataType dataType, string location, string parameters, string sepFile)
{
    Printer printer = new Printer(name, port, driver, processorName, shareName, serverName, description, dataType, location, parameters, sepFile);
    printer.TryInstall(serverName);

    return printer;
}

/// <summary>
/// Инициализирует новый экземпляр класса <see cref="Printer"/>.
/// </summary>
/// <param name="name">Наименование принтера.</param>
/// <param name="port">Порт, к которому привязан принтер.</param>
/// <param name="driver">Драйвер, который связан с принтером.</param>
/// <param name="processorName">Наименование процессора печати.</param>
/// <param name="shareName">Публичное наименование принтера.</param>
/// <param name="serverName">Имя сервера.</param>
/// <param name="description">Описание принтера.</param>
/// <param name="dataType">Тип данных печати.</param>
/// <param name="location">Местоположение принтера.</param>
/// <param name="parameters">Параметры принтера.</param>
/// <returns>Экземпляр устройства печати.</returns>
public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName, string serverName, string description,
    DataType dataType, string location, string parameters)
    => RunPrinter(name, port, driver, processorName, shareName, serverName, description, dataType, location, parameters, null);

/// <summary>
/// Инициализирует новый экземпляр класса <see cref="Printer"/>.
/// </summary>
/// <param name="name">Наименование принтера.</param>
/// <param name="port">Порт, к которому привязан принтер.</param>
/// <param name="driver">Драйвер, который связан с принтером.</param>
/// <param name="processorName">Наименование процессора печати.</param>
/// <param name="shareName">Публичное наименование принтера.</param>
/// <param name="serverName">Имя сервера.</param>
/// <param name="description">Описание принтера.</param>
/// <param name="dataType">Тип данных печати.</param>
/// <param name="location">Местоположение принтера.</param>
/// <returns>Экземпляр устройства печати.</returns>
public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName, string serverName, string description,
    DataType dataType, string location)
    => RunPrinter(name, port, driver, processorName, shareName, serverName, description, dataType, location, null);

/// <summary>
/// Инициализирует новый экземпляр класса <see cref="Printer"/>.
/// </summary>
/// <param name="name">Наименование принтера.</param>
/// <param name="port">Порт, к которому привязан принтер.</param>
/// <param name="driver">Драйвер, который связан с принтером.</param>
/// <param name="processorName">Наименование процессора печати.</param>
/// <param name="shareName">Публичное наименование принтера.</param>
/// <param name="serverName">Имя сервера.</param>
/// <param name="description">Описание принтера.</param>
/// <param name="dataType">Тип данных печати.</param>
/// <returns>Экземпляр устройства печати.</returns>
public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName, string serverName, string description,
    DataType dataType)
    => RunPrinter(name, port, driver, processorName, shareName, serverName, description, dataType, null);

/// <summary>
/// Инициализирует новый экземпляр класса <see cref="Printer"/>.
/// </summary>
/// <param name="name">Наименование принтера.</param>
/// <param name="port">Порт, к которому привязан принтер.</param>
/// <param name="driver">Драйвер, который связан с принтером.</param>
/// <param name="processorName">Наименование процессора печати.</param>
/// <param name="shareName">Публичное наименование принтера.</param>
/// <param name="serverName">Имя сервера.</param>
/// <param name="description">Описание принтера.</param>
/// <returns>Экземпляр устройства печати.</returns>
public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName, string serverName, string description)
    => RunPrinter(name, port, driver, processorName, shareName, serverName, description, DataType.RAW);

/// <summary>
/// Инициализирует новый экземпляр класса <see cref="Printer"/>.
/// </summary>
/// <param name="name">Наименование принтера.</param>
/// <param name="port">Порт, к которому привязан принтер.</param>
/// <param name="driver">Драйвер, который связан с принтером.</param>
/// <param name="processorName">Наименование процессора печати.</param>
/// <param name="shareName">Публичное наименование принтера.</param>
/// <param name="serverName">Имя сервера.</param>
/// <returns>Экземпляр устройства печати.</returns>
public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName, string serverName)
    => RunPrinter(name, port, driver, processorName, shareName, serverName, null);

/// <summary>
/// Инициализирует новый экземпляр класса <see cref="Printer"/>.
/// </summary>
/// <param name="name">Наименование принтера.</param>
/// <param name="port">Порт, к которому привязан принтер.</param>
/// <param name="driver">Драйвер, который связан с принтером.</param>
/// <param name="processorName">Наименование процессора печати.</param>
/// <param name="shareName">Публичное наименование принтера.</param>
/// <returns>Экземпляр устройства печати.</returns>
public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName)
    => RunPrinter(name, port, driver, processorName, shareName, null);

/// <summary>
/// Инициализирует новый экземпляр класса <see cref="Printer"/>.
/// </summary>
/// <param name="name">Наименование принтера.</param>
/// <param name="port">Порт, к которому привязан принтер.</param>
/// <param name="driver">Драйвер, который связан с принтером.</param>
/// <param name="processorName">Наименование процессора печати.</param>
/// <returns>Экземпляр устройства печати.</returns>
public Printer RunPrinter(string name, Port port, Driver driver, string processorName) => RunPrinter(name, port, driver, processorName, null);

/// <summary>
/// Инициализирует новый экземпляр класса <see cref="Printer"/>.
/// </summary>
/// <param name="name">Наименование принтера.</param>
/// <param name="port">Порт, к которому привязан принтер.</param>
/// <param name="driver">Драйвер, который связан с принтером.</param>
/// <returns>Экземпляр устройства печати.</returns>
public Printer RunPrinter(string name, Port port, Driver driver) => RunPrinter(name, port, driver, "WinPrint");

IEnumerable<Printer> printers = Printer.All.Where(p => p.Driver?.Name == Name);
foreach (Printer printer in printers) printer.Uninstall(serverName);

/// <summary>
/// Представляет тестовый модуль класса <see cref="Printer"/>.
/// </summary>
[TestClass]
public class PrinterTests
{
    /// <summary>
    /// Наименование принтера.
    /// </summary>
    protected const string PrinterName = "Test Printer";

    /// <summary>
    /// Наименование порта.
    /// </summary>
    protected const string PortName = "TESTPORT:";
        
    /// <summary>
    /// Наименование драйвера.
    /// </summary>
    protected const string DriverName = "Test Driver";
        
    /// <summary>
    /// Тест локальной установки принтера.
    /// </summary>
    [TestMethod]
    public void InstallTest()
    {
        Printer printer = new Printer(PrinterName, PortName, DriverName);
        printer.Install();

        Assert.IsTrue(Printer.All.Select(p => p.Name).Contains(PrinterName));
    }

    /// <summary>
    /// Тест локального удаления принтера.
    /// </summary>
    [TestMethod]
    public void UninstallTest()
    {
        Printer printer = new Printer(PrinterName, PortName, DriverName);
        printer.Uninstall();

        Assert.IsFalse(Printer.All.Select(p => p.Name).Contains(PrinterName));
    }

    /// <summary>
    /// Тест локальной установки принтера с перехватом состояния установки.
    /// </summary>
    [TestMethod]
    public void TryInstallTest()
    {
        Printer printer = new Printer(PrinterName, PortName, DriverName);
        bool f = printer.TryInstall();

        Assert.IsTrue(f);
        Assert.IsTrue(Printer.All.Select(p => p.Name).Contains(PrinterName));
    }

    /// <summary>
    /// Тест локального удаления принтера с перехватом состояния удаления.
    /// </summary>
    [TestMethod]
    public void TryUninstallTest()
    {
        Printer printer = new Printer(PrinterName, PortName, DriverName);
        bool f = printer.TryUninstall();

        Assert.IsTrue(f);
        Assert.IsFalse(Printer.All.Select(p => p.Name).Contains(PrinterName));
    }
}

[TestClass]
public class PrintingApiTests
{
    protected const string MonitorName = "mfilemon";
    protected const string PortName = "TESTPORT:";
    protected const string DriverName = "Test Driver";
    protected const string PrinterName = "Test Printer";

    protected const string MonitorFile = "D:/Printing Tests/mfilemon.dll";
    protected const string DriverFile = "D:/Printing Tests/pscript5.dll";
    protected const string DriverDataFile = "D:/Printing Tests/testprinter.ppd";
    protected const string DriverConfigFile = "D:/Printing Tests/ps5ui.dll";
    protected const string DriverHelpFile = "D:/Printing Tests/pscript.hlp";

    [TestMethod]
    public void PrinterInstallationTest()
    {
        PrintingApi.TryRestart();

        Monitor monitor = PrintingApi.Factory.CreateMonitor(MonitorName, MonitorFile);
        Port port = PrintingApi.Factory.OpenPort(PortName, monitor);
        Driver driver = PrintingApi.Factory.InstallDriver(DriverName, DriverFile, DriverDataFile, DriverConfigFile, DriverHelpFile, 3, Environment.Current, DataType.RAW, null, monitor);
        Printer printer = PrintingApi.Factory.RunPrinter(PrinterName, port, driver);

        PrintingApi.TryRestart();

        Assert.IsNotNull(printer);
    }
}