Return values |
Description |
0 |
Driver installation was successful. |
-1 |
A NULL parameter has been passed to the function. |
-2 |
An Invalid parameter has been passed to the function. Please check that there are no invalid characters in the driver component names. The following characters are not allowed: · In file names: < > : \ " / | ? * · In port names: * ? | , · In the printer name: \ , |
-3 |
The parameter is too long. Please check that the parameters do not exceed the maximum allowed characters below: · File names (without path): 160 · File paths: 259 · Port Monitor name: 63 · Port name: 246 · Print Processor name: 255 · Printer name: 220 · Driver name: 255 |
-4 |
An empty string parameter has been passed to the function. |
-5 |
The specified Driver type is invalid. The driver type can be one of the following values: · Color Desktop: 0 · TIFF/Monochrom Desktop: 1 · EMF Desktop: 2 · Color Server: 3 · TIFF/Monochrome Server: 4 · EMF Server: 5 · PDF Desktop: 6 · PDF Server: 7 · ColorPlus Desktop: 8 · ColorPlus Server: 9 |
-6 |
The specified file does not exist. |
-7 |
Could not create registry keys for the Printer Driver. Please see the error message in the log file for the Windows error. |
-8 |
Failed to configure the Port Monitor. Please see the error message in the log file for the Windows error. |
-9 |
The Printer Driver is being installed on an unsupported version of Windows. The Desktop printer drivers must be installed on Windows 11/10/etc. systems, and the Server drivers must be installed on Windows Server 2025/2022/2019/etc. systems. |
-10 |
The specified Printer already exists. |
-11 |
The specified Printer Driver already exists. |
-12 |
The specified Port already exists. |
-13 |
The specified Port Monitor already exists. |
-14 |
The specified Print Processor already exists. |
-17 |
Could not add port to the Port Monitor |
-20 |
The driver name is not specified in the INF file. Make sure it is specified in the [BIDRIVER_DATA] section. |
-21 |
The configuration INI file name is not specified in the INF file. Make sure it is specified in the [BIDRIVER_DATA] section. |
-22 |
Could not read the MSI parameters from the registry. |
-24 |
Failed to enumerate the Ports in the system. |
-26 |
The specified Printer Driver is not installed. |
-28 |
The specified Port Monitor is not installed. |
-29 |
The specified Print Processor is not installed. |
-30 |
The specified printer uses an unknown Printer Driver. |
-31 |
Cannot set the number of ports on a printer, because the ports used by the printer cannot be determined. |
-32 |
The specified printer uses an unknown Port Monitor. |
-33 |
The specified printer uses an unknown Print Processor. |
-34 |
Failed to enumerate the Printers in the system. |
-35 |
Could not create a new Port for the Port Monitor. |
-36 |
The full path was passed as a parameter even though the function requires the file name only. |
-37 |
Only the file name was passed as a parameter, even though the function requires the full path. |
-38 |
The printer driver is too old to support multiple threads. |
-39 |
Setting the port count is only supported by the Black Ice Printer Drivers version 14.97 and above. |
-41 |
The Base Printer for the Agent Printer cannot be found. |
-42 |
Could not open the specified Base Printer. Please see the error message in the log file for the Windows error. |
-43 |
Could not add Agent Printer to the system. Please see the error message in the log file for the Windows error. |
-44 |
Could not retrieve Agent Printer settings from the system. Please see the error message in the log file for the Windows error. |
-45 |
Could not set the Agent Printer settings. Please see the error message in the log file for the Windows error. |
-46 |
Memory allocation error. Out of memory. |
-47 |
Error while copying Agent Printer settings from the Base Printer. |
-48 |
Cannot delete Agent Printer while printing is in progress. |
-49 |
Failed to delete Agent Printer. Please see the error message in the log file for the Windows error. |
-50 |
A printer with the specified name already exists. |
-51 |
The specified printer is not a Black Ice printer. |
-52 |
Cannot add more than 16 ports to a printer. |
Otherwise returns a Windows system error code. |
|
Common error codes:
Error code: 5:
The dAddPortMonitor function cannot access the port monitor dll (BuXMonYY.dll) or access the registry (HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print\Monitors\)
Error code: 126:
The port monitor dll (BuXMonYY.dll) is not found in the System32 directory.
Error code: 127:
The port monitor dll (BuXMonYY.dll) version is not correct in the System32 directory.
Error code: 193:
The port monitor dll (BuXMonYY.dll) is not valid for the current platform (32-bit / 64-bit mismatch)
Error code: 1722:
Print Spooler service is not running
Error code: 1805:
The system has an ARM-based processor (E.g.: Apple M1, M2, Qualcomm Snapdragon, etc), but you are trying to install the non-ARM version.
Authenticode Error code:
-2146500030 (0x800F0242)
The publisher of an Authenticode(tm) signed catalog has not yet been established as trusted.
Install the following fixes on Windows 7:
https://technet.microsoft.com/en-us/library/security/3033929.aspx
-2146500025 (0x800F0247)