L_EpnLockOEMPrinter

#include "l_eprint.h"

L_INT EXT_FUNCTION L_EpnLockOEMPrinter (pszPrinterName, pszPassword);

L_CHAR L_FAR * pszPrinterName;

/* OEM printer name */

L_CHAR L_FAR * pszPassword;

/* OEM administration password */

Locks a specified OEM printer to prevent applications from directly printing to it.

Parameter

Description

pszPrinterName

Character string that contains the OEM printer name.

pszPassword

Character string that contains the OEM administration password.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Support for OEM functionality must be unlocked by calling the L_EpnUnlockSupport function before using this function.

Call this function to lock the OEM printer. OEM printers are installed by calling L_EpnInstallOEMPrinter. When L_EpnInstallOEMPrinter was called, the string passed to the pszPassword parameter must be the same as the string set in the pszOEMPassword member of the EPNOEMPRINTERINFO structure.

If the OEM printer is locked, the user can use it indirectly by using one of the following functions:

L_EpnCreateEmailDC

L_EpnCreateRedirectionDC

L_EpnCreateSaveDC

For more information, refer to Locking and Unlocking the OEM ePrint Printer.

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_EpnUnlockSupport, L_EpnUnlockOEMPrinter, L_EpnIsOEMPrinterLocked L_EpnCreateSaveDC, L_EpnCreateRedirectionDC, L_EpnCreateEmailDC, L_EpnInstallOEMPrinter, L_EpnUninstallOEMPrinter

Topics:

ePrint: Locking and Unlocking OEM Printers

 

Using the OEM Version of ePrint

Types of Printers

Example

For an example, refer to L_EpnIsOEMPrinterLocked.