Redistributing Your Applications
Once an application is finished and ready to redistribute, the developer must create a setup.exe that includes all of the necessary files.
Files to Be Included with Your Application
The following summarizes which files to include on your distribution diskettes to support LEADTOOLS Virtual Printer Driver functions on WIN32 and x64 systems.
Note: You may not copy or redistribute any of the following files without obtaining the proper license. In some cases, the license is included with your initial purchase of LEADTOOLS. In other cases, you must obtain a license from a third party or enter into a royalty agreement with LEAD to obtain the proper license.
General Notes:
- The \Redist\ subdirectories contain copies of these files.
- Leadtools.Printer.dll is required for all applications.
Environment-Specific notes:
- 32-bit Operating Systems: Unless otherwise noted, all 32-bit files should be deployed to the System32 folder as shared files.
- 64-bit Operating Systems: Unless otherwise noted, all 32-bit files should be deployed to the SysWow64 folder and all 64-bit files should be deployed to the System32 folder as shared files.
- XP / Server 2003: If running within a service on an XP or Server 2003 machine you may run into an issue where the printer installs but doesn't receive the events. This is a result of the default DCOM authentication settings. To correct this, go to Start -> Run and enter "dcomcnfg". Then right click on Component Services -> Computers -> My Computer and select properties. On the Default Properties tab select "None" for the Default Authentication Level.
Note: If the virtual printer is run within a Windows Service in Windows XP or Windows Server 2003 you may get an issue where the printer installs but does not receive events. This is a result of the default DCOM authentication settings. To fix this issue:
- Go to the Start menu->Run and enter "dcomcnfg".
- Right click on Computer Services ->Computers -> My Computer and select properties.
- On the Default Properties tab select None for the Default Authentication Level.
Destination directory structure specification:
Use the Leadtools.Printer.Printer.Install(Leadtools.Printer.PrinterInfo) method to install the LEADTOOLS Virtual Printer Module. Pass the structure PrinterInfo to this function. The installation path specified in the RootDir member of the PrinterInfo structure is the root folder in which the LEADTOOLS Virtual Printer is installed. This folder should contain two sub-folders:
- -\Bin - This folder should contain the LeadtoolsPrinter.exe executable file.
- -\Spool - Used to store temporary files generated while printing.
Note: All users of the printer must have access to the folder specified in the Leadtools.Printer.PrinterInfo.RootDir member.
Required LeadtoolsPrinter.exe files:
- These can be found in the <installationdir>\Redist\Virtual Printer\Common\Bin\ directory, where <installationdir> represents the directory in which you installed the LEADTOOLS toolkit.
- This file should be placed in the Bin folder as described in the Destination directory structure specification section above.
Required COM Servers:
- These can be found in the <installationdir>\Redist\Virtual Printer\Common\ComSvr\ directory, where <installationdir> represents the directory in which you installed the LEADTOOLS toolkit.
- This file should be placed in the Bin folder as described in the Destination directory structure specification section above.
-
Files required for all operating systems:
Redistributables (32-bit) Explanation LPCLB06N.DLL LEADTOOLS Printer COM server. Should be registered using regsvr32 (regsvr32 LPCLB06N.DLL). LPCMG06N.exe LEADTOOLS Printer COM Server. Should be registered using /RegServer (LPCMG06N /Regserver) LPWSE06N.EXE LEADTOOLS Printer COM Server. Should be registered using /RegServer (LPWSE06N /Regserver) and unregistered using /UnRegServer (LPWSE06N /UnRegServer). LPCPN06N.dll LEADTOOLS Printer COM server, Should be registered using regsvr32 (regsvr32 LPCPN06N.DLL). LPPRNCON.DLL LEADTOOLS Printer COM server. Should be registered using regsvr32 (regsvr32 LPPRNCON.DLL). LpPrinterThunk.exe LEADTOOLS Printer COM Server. Should be registered using /RegServer (LpPrinterThunk /Regserver) and unregistered using /UnRegServer (LpPrinterThunk / UnRegServer).
Required DLLs for Windows 2000/XP/Vista Win32:
- These files can be found in the <installationdir>\Redist\Virtual Printer\Dll\Win32\ directory, where <installationdir> represents the directory in which you installed the LEADTOOLS toolkit.
- These files should be deployed only for 32-bit Windows.
Redistributables (32-bit) | Explanation |
LPDRV06N.DLL | Driver DLL |
LPUID06N.DLL | Driver DLL |
LPUMD06N.DLL | Port DLL |
LPPMN06U.DLL | Driver DLL |
LPRES06N.DLL | Resource Driver |
LPUNI06N.DLL | Driver DLL |
Required DLLs for Windows 2000/XP/Vista x64:
- These files can be found in the <installationdir>\Redist\Virtual Printer\Dll\Winx64\ directory, where <installationdir> represents the directory in which you installed the LEADTOOLS toolkit.
- These files should be deployed only for 64-bit Windows.
Redistributables (64-bit) | Explanation |
LPDRV06x.DLL | Driver DLL |
LPPMN06x.DLL | Port DLL |
LPUID06x.DLL | Driver DLL |
LPRES06x.DLL | Resource Driver |