SetPrinterConflictSolving method (IEPrint)
|
short SetPrinterConflictSolving (BSTR pszPrinterName, OverwriteConstants ConflictSolve, IEpnRenamingOptions * pRenamingOptions); | |
|
Overview |
Remarks
Sets the conflict solving mechanism for output file names of an ePrint printer.
Support for Basic functionality must be unlocked by calling the UnlockSupport method before using this method.
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 SetPrinterSaveOptions method. This name will be used as a template to generate file names using the naming options that were set for a printer using the SetPrinterSaveOptions method. 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.
The user should pass a valid object to the pRenamingOptions parameter if the value of ConflictSolve parameter is set to SAVE_RENAME or SAVE_APPEND_FAVOR_RENAME. Otherwise it can be NULL.
When setting the file save options of an OEM printer, the user must first install the OEM printer using InstallOEMPrinter method.
Before calling this method, the user should set the values of the following properties of the IEpnRenamingOptions object:
To get the current values for the above properties, call the GetPrinterConflictSolving method.
Note that the Alpha, AlphaNum, and Num properties are read-only interface properties that contain multiple sub-properties. Calling the SetPrinterConflictSolving method sets each individual sub-property associated with the three interface properties.
See Also
|
Elements: |
UnlockSupport method, GetPrinterConflictSolving method, SetPrinterSaveOptions method, Alpha property, AlphaNum property, Num property, Suffix property, TagOptions property |
|
Topics: |