Collapse All Expand All

LDicomPrintSCU::OnPrintJobReport

#include "ltdic.h"

virtual L_VOID LDicomPrintSCU::OnPrintJobReport(pszPrintJobInstanceUID, uEventTypeID, pReportInfo)

const L_TCHAR * pszPrintJobInstanceUID;	/* SOP Instance UID of the Print Job */
L_UINT16 uEventTypeID;	/* event Type ID */
const pPRINTJOBREPORTINFO pReportInfo;	/* print Job report info */

Called when a Print Job status report is received from the Print SCP.

Parameter	Description
pszPrintJobInstanceUID	Character string that contains the SOP Instance UID of the Print Job SOP Instance for which the status report was sent.
uEventTypeID	Specifies the Event Type ID which indicates the status of the Print Job. Possible values are:
	Value	Meaning
	1	Event Type Name = Pending
	2	Event Type Name = Printing
	3	Event Type Name = Done
	4	Event Type Name = Failure
pReportInfo	Pointer to a PRINTJOBREPORTINFO structure that specifies Print Job information. This can be NULL.

Returns

None

Comments

This callback function is called whenever the Print SCU receives a report from the Print SCP about the changes in the status of a Print Job. The intended Print Job is specified by its SOP Instance UID. If the Print Job SOP Class is supported on the Association, this function is expected to be called. Otherwise, it will never be called.

If the status of the Print Job is Pending or Failure, the Print SCP is supposed to supply additional information about the pending/error condition in the Attribute Execution Status Info (the member pszExecutionStatusInfo of the PRINTJOBREPORTINFO structure).

The implementation of the LDicomPrintSCU class for this function simply does nothing. In order to make use of this callback function, you should create a new class derived from the LDicomPrintSCU and override the function providing the desired implementation.

Required DLLs and Libraries

LTDIC For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Platforms

Win32, x64

See Also

Functions:	Class Members, LDicomPrintSCU::GetPrintJobInstanceUID, LDicomPrintSCU::GetPrintJobInfo
Topics:	Print Management SCU
	DICOM Print Management Service Class User: Functions

Example

For an example, refer to LDicomPrintSCU::OnStatus.