L_EpnSetPrinterConflictSolving

#include "l_eprint.h"

L_INT EXT_FUNCTION L_EpnSetPrinterConflictSolving (pszPrinterName, nConflictSolve, pRenamingOptions);

L_CHAR L_FAR * pszPrinterName;	/* printer name */
L_INT nConflictSolve;	/* conflict solving mechanism */
EPNRENAMINGOPTIONS L_FAR * pRenamingOptions;	/* pointer to a structure */

Sets the conflict solving mechanism for output file names of an ePrint printer.

Parameter	Description
pszPrinterName	Character string that contains the name of the ePrint printer.
nConflictSolve	Value that represents the conflict solving mechanism to be set. Possible values are:
	Value	Meaning
	EPN_SAVE_OVERWRITE	[0] Overwrites an existing file.
	EPN_SAVE_RENAME	[1] Renames an existing file.
	EPN_SAVE_SKIP	[2] Do not overwrite an existing file and skip.
	EPN_SAVE_CANCEL	[3] Do not overwrite an existing file and cancel the whole save operation when printing on the printer.
	EPN_SAVE_APPEND	[4] Appends to an existing file. If the file format does not support appending, the file will be skipped.
	EPN_SAVE_APPEND_FAVOR_OVERWRITE	[5] Appends to an existing file. If the file format does not support appending, the existing file will be overwritten.
	EPN_SAVE_APPEND_FAVOR_RENAME	[6] Appends to an existing file. If the file format does not support appending the existing file will be renamed.
pRenamingOptions	Pointer to an EPNRENAMINGOPTIONS structure that contains the file renaming options to be set.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Support for Basic functionality must be unlocked by calling the L_EpnUnlockSupport function before using this function.

File name conflicts occur, when the user prints a multi-page file, and selects to save each page as separate file. The process of saving will use the file name that was set in the Save dialog, or that was set using the L_EpnSetPrinterSaveOptions function. This name will be used as a template to generate file names using the naming options that was set for a printer using the L_EpnSetPrinterSaveOptions function. When a new file is to be created, if the generated file name already exists, a conflict will occur.

These settings will be used whenever the user prints using this ePrint printer.

When setting the file save options of an OEM printer, the user must first install the OEM printer using L_EpnInstallOEMPrinter before calling this function.

The user should pass a valid pointer to the pRenamingOptions parameter if the value of nConflictSolve parameter is set to EPN_SAVE_RENAME or EPN_SAVE_APPEND_FAVOR_RENAME. Otherwise it can be NULL.

Required DLLs and Libraries

LPKRN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to ePrint Files.

Functions:	L_EpnGetDefaultRenamingOptions, L_EpnGetPrinterConflictSolving; L_EpnSetPrinterSaveOptions
Topics:	ePrint: Getting and Setting Printer Specification
	Setting and Getting ePrint Printer Settings