PRNJOBINFOPROC

Summary

Callback function fired for every print job.

Syntax

#include "Ltprinter.h"

L_INT pEXT_CALLBACK YourFunction(pszPrinterName, dwJobID, dwFlags, pData)

Parameters

L_TCHAR * pszPrinterName

Character string that contains the name of the LEADTOOLS Virtual Printer Driver.

DWORD dwJobID

Print job ID for the document being printed.

DWORD dwFlags

Flags that indicate the status of the print job. Possible values are:

Value	Meaning
PRN_JOB_START	[0x00000001L] The print job being started.
PRN_JOB_END	[0x00000002L] The print job being ended.

L_VOID * pData

A void pointer that you can use to access a variable or structure that contains data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. This is the same pointer passed to the L_PrnRegisterJobCallback function in the pData parameter.

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

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

Comments

This callback function gives a status about the print job as it is being started or ended.

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 Application.

See Also

Functions

• L_PrnInstallPrinter
• L_PrnRegisterJobCallback
• L_PrnUnRegisterJobCallback

Topics

• LEADTOOLS Printer: Register and Un-register Callback Functions
• Register and Un-register Callback Functions

Example

For an example, refer to L_PrnRegisterJobCallback.