EPNOEMPRINTERINFO

typedef struct tag_EPNOEMPRINTERINFO
{
   L_UINT uStructSize; 
   L_CHAR L_FAR * pszOEMPrinterName; 
   L_CHAR L_FAR * pszOEMDriverName; 
   L_CHAR L_FAR * pszOEMMonitorName; 
   L_CHAR L_FAR * pszOEMPortName; 
   L_CHAR L_FAR * pszOEMProductName; 
   L_CHAR L_FAR * pszOEMSerialNumber; 
   L_CHAR L_FAR * pszOEMRegistryKey; 
   L_CHAR L_FAR * pszOEMRootDir; 
   L_CHAR L_FAR * pszOEMHelpFile; 
   L_CHAR L_FAR * pszOEMPassword; 
   L_CHAR L_FAR * pszOEMUrl; 

} EPNOEMPRINTERINFO, L_FAR * pEPNOEMPRINTERINFO;

The EPNOEMPRINTERINFO structure provides information used for installing or uninstalling OEM printers.

Member

Description

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() macro to calculate this value.

pszOEMPrinterName

Character string that contains the name of a printer in the list of locally supported printers. This is a null terminated string. It is required for both installation and uninstallation. The printer name should not include special characters such as "!", "\" and ",". It is also not recommended to use the following special characters: "/, *, ?, :, ", <, >, and |".

pszOEMDriverName

Character string that contains the name of a driver to be installed or uninstalled. This is a null terminated string. It is required for both installation and uninstallation.

pszOEMMonitorName

Reserved for future use. Pass NULL.

pszOEMPortName

Reserved for future use. Pass NULL.

pszOEMProductName

Character string that contains the product name. This is a null terminated string. It will be used for Message Box captions and is required for installation.

pszOEMSerialNumber

Character string that contains the serial number. This is a null terminated string. It is required for installation.

pszOEMRegistryKey

Character string that contains the OEM registry key. This is a null terminated string. The registry key is used to store the current user-specific settings.

pszOEMRootDir

Character string that contains the installation path. This is a null terminated string. It is required for installation.

pszOEMHelpFile

Character string that contains the name of the help file associated with this printer. This is a null terminated string. It is required for installation.

pszOEMPassword

Character string that contains the administration password to be used when locking or unlocking the OEM Printer. This is a null-terminated string. It is not required for installation or uninstallation. Pass NULL to disable the ability to lock the printer. For more information, refer to L_EpnLockOEMPrinter and L_EpnUnlockOEMPrinter.

pszOEMUrl

Character string that contains the URL (for example, the OEM's support URL) to be displayed in the message box that appears when the user tries to print directly to a Locked OEM printer. This is a null-terminated string. It is not required for installation or uninstallation. Please note that the URL length should be less than 48 characters in normal font and style, and before the final deployment of an application, verify that the URL used fits within the message box. If no URL is provided, the ePrint URL will be used (http://www.eprintdriver.com/). For more information, refer to Locking and Unlocking the OEM ePrint PrinterLockingandUnlockingtheOEMePrintPrinter.

Comments

The installation path specified in the pszOEMRootDir member is the root folder in which the OEM version of ePrint is installed. This folder should contain two sub-folders:

 

Note: All users of this printer must have access to the folder passed to the pszOEMRootDir member.

This structure is used within the L_EpnInstallOEMPrinter and L_EpnUninstallOEMPrinter functions.