L_PrnLockPrinter

Summary

Locks the specified LEADTOOLS Virtual Printer Driver to prevent applications from directly printing to it.

Syntax

#include "Ltprinter.h"

L_LTPRINTER_API L_INT EXT_FUNCTION L_PrnLockPrinter(pszPrinterName, pszPassword)

Parameters

L_TCHAR * pszPrinterName

Character string that contains the printer's name.

L_TCHAR * pszPassword

Character string that contains the printer administrative password.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

The value of pszPassword parameter must be the same as the value of PRNPRINTERINFO.pszPassword member used when the printer was installed using the L_PrnInstallPrinter function.

To unlock the specified LEADTOOLS Virtual Printer Driver and enable applications to print directly to it, call the L_PrnUnlockPrinter function.

To check whether applications were prevented from directly printing to the specified LEADTOOLS Virtual Printer Driver, call the L_PrnIsPrinterLocked function.

Required DLLs and Libraries

• LTPRINTER
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your LEADTOOLS Virtual Printer Driver Application.

Platforms

Win32, x64.

See Also

Functions

• L_PrnUnlockPrinter
• L_PrnIsPrinterLocked
• L_PrnInstallPrinter
• L_PrnUninstallPrinter

Topics

• LEADTOOLS Virtual Printer: Locking and Unlocking LEADTOOLS Virtual Printer Drivers
• Working with the LEADTOOLS Virtual Printer Driver

Example

For an example, refer to L_PrnInstallPrinter.