L_EpnSetPrinterUISettings

#include "l_eprint.h"

L_INT EXT_FUNCTION L_EpnSetPrinterUISettings (pszPrinterName, pUISettings)

L_CHAR L_FAR * pszPrinterName;	/* printer name */
EPNUISETTINGS L_FAR * pUISettings;	/* pointer to a structure */

Sets the user interface configuration of an ePrint printer.

Parameter	Description
pszPrinterName	Character string that contains the name of the ePrint printer.
pUISettings	Pointer to an EPNUISETTINGS structure that contains the user interface configuration 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.

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

When setting user interface configuration of an OEM printer, the user must first install the OEM printer using L_EpnInstallOEMPrinter before calling this function.

Required DLLs and Libraries

LPKRN

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

See Also

Functions:	L_EpnInstallOEMPrinter, L_EpnFreePrinterUISettings, L_EpnGetPrinterUISettings
Topics:	ePrint: Getting and Setting Printer Specification
	Setting and Getting ePrint Printer Settings

Example

L_VOID SetUserInterfaceSettings( )
{
   EPNUISAVEFORMATS UIFormats[ ] =
   {
      {
         sizeof( EPNUISAVEFORMATS ),
         DLG_FT_SAVE_TYPE_RASTER,
         FILE_CMP
      },
      {
         sizeof( EPNUISAVEFORMATS ),
         DLG_FT_SAVE_TYPE_RASTER,
         FILE_JFIF
      },
      {
         sizeof( EPNUISAVEFORMATS ),
         DLG_FT_SAVE_TYPE_VECTOR,
         FILE_EMF
      },
      {
         sizeof( EPNUISAVEFORMATS ),
         DLG_FT_SAVE_TYPE_DOCUMENT,
         FILE_EPN_PDF
      }
   };

   EPNUISETTINGS UISettings;
   ZeroMemory( & UISettings, sizeof( EPNUISETTINGS ) );
   UISettings.uStructSize = sizeof( EPNUISETTINGS );
   UISettings.pszAboutString = "about string";
   UISettings.pszAboutIcon = "C:\\Program Files\\OEM eprint/ICON.ICO";
   UISettings.uShowOptions = EPN_HIDE_PAPER_TAB | EPN_HIDE_GRAPHICS_TAB;
   UISettings.uFormatsCount = sizeof( UIFormats ) / sizeof( EPNUISAVEFORMATS );
  UISettings.pSaveFormats = UIFormats;
  L_EpnSetPrinterUISettings( "Test Printer Name", & UISettings );

}