无管理员权限安装网络打印机时遇Generic failure错误求助

问题描述 #

尝试在无管理员权限的情况下安装本地网络打印机，执行CreatePrinter函数时触发catch块，报错：Error CreatePrinter: Generic failure.

附相关PrinterInstaller类代码：

namespace ClassName
{
    public class PrinterInstaller
    {
        private string printerIP = "127.0.0.1";
        private string driverName = "Generic / Text Only";
        private string printerName = "printerName";
        private string PrinterPortName = "printerName";
        private int listeningPort = 9200;
        private ManagementScope managementScope;

        [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)]
        public static extern bool SetDefaultPrinter(string Name);

        public PrinterInstaller()
        {
            CreateManagementScope();
        }

        private void CreateManagementScope()
        {
            var wmiConnectionOptions = new ConnectionOptions
            {
                Impersonation = ImpersonationLevel.Impersonate,
                Authentication = AuthenticationLevel.Default,
                EnablePrivileges = true
            };

            string path = $@"\\.\root\cimv2";
            managementScope = new ManagementScope(path, wmiConnectionOptions);
            managementScope.Connect();
        }

        private bool CheckPrinterPort()
        {
            try
            {
                ObjectQuery query = new ObjectQuery($"SELECT * FROM Win32_TCPIPPrinterPort WHERE HostAddress = '{printerIP}' AND PortNumber = {listeningPort}");
                ManagementObjectSearcher searcher = new ManagementObjectSearcher(managementScope, query);
                ManagementObjectCollection queryCollection = searcher.Get();
                return queryCollection.Count > 0;
            }
            catch (Exception ex)
            {
                LogHelper.Log("Error CheckPrinterPort: " + ex.Message);
                MessageBox.Show("Error CheckPrinterPort: " + ex.Message);
                return false;
            }
        }

        private bool CreatePrinter()
        {
            try
            {
                var printerClass = new ManagementClass(managementScope, new ManagementPath("Win32_Printer"), new ObjectGetOptions());
                printerClass.Get();
                var printer = printerClass.CreateInstance();

                if (printer != null)
                {
                    printer.SetPropertyValue("DriverName", driverName);
                    printer.SetPropertyValue("PortName", PrinterPortName);
                    printer.SetPropertyValue("Name", printerName);
                    printer.SetPropertyValue("DeviceID", printerName);
                    printer.SetPropertyValue("Location", printerName);
                    printer.SetPropertyValue("Network", true);
                    printer.SetPropertyValue("Shared", false);
                    printer.Put();
                    return true;
                }
                else
                {
                    LogHelper.Log("Error creating printer instance.");
                    MessageBox.Show("Error creating printer instance.");
                    return false;
                }
            }
            catch (Exception ex)
            {
                LogHelper.Log("Error CreatePrinter: " + ex.Message);
                MessageBox.Show("Error CreatePrinter: " + ex.Message);
                return false;
            }
        }

        internal bool InstallPrinterWMI()
        {
            try
            {
                bool printerPortExists = CheckPrinterPort();
                bool printerCreated = CreatePrinter();

                if (printerPortExists && printerCreated)
                {
                    // Set as the default printer (optional)
                    SetDefaultPrinter(printerName);

                    return true;
                }

                return false;
            }
            catch (Exception ex)
            {
                LogHelper.Log("Error while installing printer: " + ex.Message);
                MessageBox.Show("Error while installing printer: " + ex.Message);
                return false;
            }
        }

        internal bool UnInstallPrinter()
        {
            try
            {
                // Delete printer
                var printerClass = new ManagementClass(managementScope, new ManagementPath("Win32_Printer"), new ObjectGetOptions());
                ManagementObjectCollection printers = printerClass.GetInstances();

                foreach (ManagementObject printer in printers)
                {
                    if (printer["Name"].ToString() == printerName)
                        printer.Delete();
                }

                // Delete printer port
                ObjectQuery query = new ObjectQuery("SELECT * FROM Win32_TCPIPPrinterPort WHERE HostAddress = '" + printerIP + "' AND PortNumber = " + listeningPort);
                ManagementObjectSearcher searcher = new ManagementObjectSearcher(managementScope, query);

                ManagementObjectCollection queryCollection = searcher.Get();
                foreach (ManagementObject port in queryCollection)
                {
                    port.Delete();
                }

                return true;
            }
            catch (Exception)
            {
                return false;
            }
        }

        //{other private functions....}//
    }
}

排查方向 #

1. 无管理员权限的核心限制 #

WMI调用Win32_Printer.CreateInstance创建打印机，默认要求管理员权限——普通用户账户没有修改系统打印机配置的权限，这是最可能的触发原因。可以先尝试用管理员权限运行程序验证，若能成功则直接确认是权限问题。

2. 缺失打印机端口创建逻辑 #

代码仅检查端口是否存在，但未实现端口创建逻辑：如果目标端口不存在，CreatePrinter中指定的PortName无效，会直接导致失败。补充端口创建逻辑示例：

private bool CreatePrinterPort()
{
    try
    {
        if (CheckPrinterPort()) return true;
        
        var portClass = new ManagementClass(managementScope, new ManagementPath("Win32_TCPIPPrinterPort"), new ObjectGetOptions());
        var port = portClass.CreateInstance();
        
        port.SetPropertyValue("Name", PrinterPortName);
        port.SetPropertyValue("HostAddress", printerIP);
        port.SetPropertyValue("PortNumber", listeningPort);
        port.SetPropertyValue("Protocol", 1); // 1代表RAW协议，2代表LPR
        port.SetPropertyValue("SNMPEnabled", false);
        
        port.Put();
        return true;
    }
    catch (Exception ex)
    {
        LogHelper.Log("Error CreatePrinterPort: " + ex.Message);
        MessageBox.Show("Error CreatePrinterPort: " + ex.Message);
        return false;
    }
}

之后在InstallPrinterWMI中先调用CreatePrinterPort，再执行CreatePrinter。

3. 驱动名称不匹配 #

Generic / Text Only是英文系统的驱动名称，中文系统可能显示为通用/仅文本，不同系统版本的驱动名称也可能有差异。可以通过两种方式确认准确名称：

• 打开「控制面板→设备和打印机→打印服务器属性→驱动程序」查看已安装驱动的准确名称；
• 用WMI查询已安装驱动列表：

ObjectQuery query = new ObjectQuery("SELECT Name FROM Win32_PrinterDriver");
ManagementObjectSearcher searcher = new ManagementObjectSearcher(managementScope, query);
foreach (var driver in searcher.Get())
{
    Console.WriteLine(driver["Name"]);
}

4. 捕获更详细的错误信息 #

当前代码仅捕获Exception.Message，无法定位具体问题。可以补充捕获ManagementException获取WMI专属错误码：

catch (ManagementException ex)
{
    LogHelper.Log($"Error CreatePrinter: {ex.Message}, 错误码: {ex.ErrorCode}, 状态码: {ex.StatusCode}");
    MessageBox.Show($"Error CreatePrinter: {ex.Message}, 错误码: {ex.ErrorCode}");
    return false;
}
catch (Exception ex)
{
    LogHelper.Log($"Error CreatePrinter: {ex.Message}, 调用栈: {ex.StackTrace}");
    MessageBox.Show($"Error CreatePrinter: {ex.Message}");
    return false;
}

比如错误码0x80070005代表权限不足，0x80041001代表WMI操作错误，能精准定位问题类型。

5. 尝试替代方案 #

如果必须无管理员权限安装，可以尝试使用Windows自带的printui.dll命令行工具，普通用户大概率可以执行：

rundll32 printui.dll,PrintUIEntry /if /b "printerName" /f "驱动文件路径.inf" /r "printerPortName" /m "驱动名称"

可以在C#中通过Process.Start调用该命令。

内容的提问来源于stack exchange，提问作者Shahryar Faraji