L_DicomPrintSCUGetPrintJobInstanceUID

Syntax

L_LTDIC_API const L_TCHAR* L_DicomPrintSCUGetPrintJobInstanceUID(hPrintSCU)

Parameters

HDICOMPRINTSCU hPrintSCU

A handle to Dicom Print SCU.

Returns

The SOP Instance UID of the Print Job SOP Instance resulted from the last successful printing request sent to the Print SCP. If the Print SCP for the last printing request did not creat a Print Job, the function will return an empty string.

Comments

Each of the functions L_DicomPrintSCUPrintFilmSession, L_DicomPrintSCUPrintFilmBox, and L_DicomPrintSCUPrintPullPrintRequestSession requests the Print SCP to print one or more films. If the Print Job SOP Class is supported on the Association, the Print SCP is supposed to create a Print Job SOP Instance for the new Print Job and send the SOP Instance UID of that Instance in the response to the printing request. The function GetPrintJobInstanceUID returns that SOP Instance UID.

The SOP Instance UID of a Print Job can be used to query the Print SCP for information about the Print Job (refer to the function L_DicomPrintSCUGetPrintJobInfo). Also, it is used to identify the Print Job when status reports are received from the Print SCP (refer to the function RECEIVENREPORTRESPONSECALLBACK).

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, Linux.

See Also

Functions

• L_DicomPrintSCUPrintFilmSession
• L_DicomPrintSCUPrintFilmBox
• L_DicomPrintSCUPrintPullPrintRequestSession
• PRINTSCUPRINTJOBREPORT
• L_DicomPrintSCUGetPrintJobInfo

Topics

• Print Management SCU

Example

For an example, refer to L_DicomPrintSCUUpdateImageBox.