L_EpnGetPrinterConflictSolving

#include "l_eprint.h"

L_INT EXT_FUNCTION L_EpnGetPrinterConflictSolving (pszPrinterName,pnConflictSolve, pRenamingOptions);

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

Gets 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.
pnConflictSolve	Pointer to a variable to be updated with the conflict solving mechanism. 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 to be updated with the renaming files options of the ePrint printer.

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.

If the retrieved value of the pnConflictSolve parameter is EPN_SAVE_RENAME or EPN_SAVE_APPEND_FAVOR_RENAME, the pRenamingOptions parameter will be filled with the renaming files options. Otherwise it will not be filled.

The user can pass NULL to the pRenamingOptions parameter if it is not desired to get the renaming files options.

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_EpnSetPrinterConflictSolving
Topics:	ePrint: Getting and Setting Printer Specification
	Setting and Getting ePrint Printer Settings