Printer Port and Registry Settings / PDF Printer
The installed printer will read a short list of settings from the computer's registry database. Most settings are determined by the configuration files but some of the information used by the low-level processes are read from registry.
- Disable Impersonation
- Application Data
- Common Application Data
- Local Application Data
All these settings are located under the printer's private registry key:
The last part of the key name depends on the printer name.
The GUITimeout setting controls how the printer port starts the gui.exe process. This process is where the actual conversion from Postscript to PDF or image formats take place. Conversion is started by the port when the Postscript is spooled. By default, the port continues with the next print job as soon as the gui.exe process is started.
Using the GUITimeout setting you can change this behavior. The value of GUITimeout is a number of milliseconds to wait for the gui.exe process to finish. In case the gui.exe process has not finished within this time limit, an error is reported by the port. Specifying -1 as the timeout value will make the port wait forever for the process to terminate. That will make sure that no more than one process is running at any given time. This can be used if you automate a sequence of appended print jobs with the Append If Exists feature.
GUITimeout defaults to 600000 (10 minutes) if the setting is not found in the registry.
Before version 10.24 the default was 0 (zero).
|0||The port continues with the next job as soon as the gui.exe process is started. Multiple conversions can run simultaneously.|
|-1||The port waits until the gui.exe process has terminated before starting the next print job from the spooler queue.|
|> 0||The port waits the number of milliseconds specified in the value. An error is reported and the gui.exe is terminated if it runs longer than the specified timeout.|
GUITimeout is specified in the computer registry under the key shown below.
It is a string value named
GUITimeout and the content is an integer.
GUITimeout was introduced with version 22.214.171.1248.
When print jobs are created by users with limited permissions on the system where the printer is installed, it can be useful to create the PDF in the user context of the print spooler service instead of the user associated with the print job.
Setting Disable Impersonation to 1 will make the PDF creation run in the user context of the print spooler.
This setting is normally used when the printer is shared on the network or print jobs are created from a web server.
Name: Disable Impersonation
Value: 1 will disable impersonation.
Use this setting to override the default location for creation of temporary files during PDF creation. When a PDF is created, the virtual printer will create multiple temporary files. These files are removed after the PDF is created. Setting the TempFolder value will give you control over the location and make it easier for you to apply specific security settings.
Value: Full path to folder where temporary files should be created.
The application data folder is where the printer stores files such as the settings.ini. This is the file created by the options dialog and determines the settings for the PDF creation. Normally, this folder is user specific meaning that every user on the machine has an individual settings.ini file. By overriding the default location for the application data folder, you can make this folder the same for all users.
Name: Application Data
Value: Full path to folder where application data is stored.
Common Application Data
The folder for common application data is where the printer normally stores information that should be the same for all users on the machine. This is where files such as global.ini are stored.
Name: Common Application Data
Value: Full path to folder where common application data is stored.
Local Application Data
The possibility to override the setting for the local application data folder is only used to control the evaluation of the <localapplicationdata> macro.
Name: Local Application Data
Value: Full path to folder where local application data is stored.
The virtual print port monitor used by the Print Spooler service will use this setting to locate the correct instance of gui.exe to launch.
Value: Full path to folder where the application is installed.
Normally log files are stored with the temporary files. This can be changed if you use this setting to specify an alternative location.
Value: Full path to folder where the log files are stored.
Process priority can be controlled by setting the PriorityClass setting. Valid values are idle, high, realtime, below normal, and above normal. The priority setting is normally used to lower the priority for the PDF creation process. This will make sure that heavy PDF jobs does not consume CPU resources from other processes.
Value: idle, high, realtime, below normal, above normal