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:
\Bin. This folder should contain one of the following executable files depending on the type of printer you install:
For an ePrint Normal OEM Printer this folder should contain the executable file "ePrint.exe".
For an ePrint OEM Task Printer this folder should contain the executable file "TaskePrint.exe".
\Spool. Used to store temporary files generated when printing.
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.