LEADTOOLS Medical (Leadtools.Dicom assembly)
LEAD Technologies, Inc

GetPrintJobInformation Method








The SOP Instance UID of the Print Job whose information is to be retrieved. The method will fail if this is a null reference (Nothing in Visual Basic) or if an empty string is specified.
A DicomPrintJobInformation object that specifies the Print Job information to be retrieved. If this is set to a null reference (Nothing in Visual Basic), then it will be assumed that the Values of all the Attributes are required.
Queries the Print SCP for information about the specified Print Job and returns the retrieved information. .NET support
Syntax
'Declaration
 
Public Function GetPrintJobInformation( _
   ByVal printJobInstanceUid As String, _
   ByVal requiredPrintJobInformation As DicomPrintJobInformation _
) As DicomPrintJobInformation
'Usage
 
Dim instance As DicomPrintScu
Dim printJobInstanceUid As String
Dim requiredPrintJobInformation As DicomPrintJobInformation
Dim value As DicomPrintJobInformation
 
value = instance.GetPrintJobInformation(printJobInstanceUid, requiredPrintJobInformation)
ObjectiveC Syntax
 function Leadtools.Dicom.DicomPrintScu.GetPrintJobInformation( 
   printJobInstanceUid ,
   requiredPrintJobInformation 
)

Parameters

printJobInstanceUid
The SOP Instance UID of the Print Job whose information is to be retrieved. The method will fail if this is a null reference (Nothing in Visual Basic) or if an empty string is specified.
requiredPrintJobInformation
A DicomPrintJobInformation object that specifies the Print Job information to be retrieved. If this is set to a null reference (Nothing in Visual Basic), then it will be assumed that the Values of all the Attributes are required.

Return Value

A DicomPrintJobInformation object that specifies the Print Job information sent by the Print SCP. If an Attribute was not included in the response of the Print SCP, the corresponding property, in the returned object, is set to an empty string.
Remarks
Two of the exceptions that can be thrown by this method are:
Exception Type Condition
DicomExceptionCode.PrintSCUFailureStatus The response of the Print SCP specifies a Failure status code.
DicomExceptionCode.PrintSCUClassNotSupported The Print Job SOP Class is not supported on the Association.

The method will not return until it receives the response of the Print SCP, or an error occurs. The method GetLastOperationStatus can be used to obtain the status code specified in the response of the Print SCP. If the method GetPrintJobInformation is successful, the required Print Job information was retrieved successfully, with either a Success or Warning status code in the response of the Print SCP.

The parameter requiredPrintJobInformation specifies the Print Job information to be retrieved. In the DicomPrintJobInformation class, all properties are strings. To query the Print SCP for the Value of an Attribute, the corresponding property, in the passed object, mustn't be a null reference (Nothing in Visual Basic); it can be set to an empty string for example. If a property is a null reference, the corresponding Attribute will not be included in the request. However, if all the properties are set to null references, the Print SCP will be queried for the Values of all the Attributes.

Example
For an example, refer to Associate(String,Int32,String,String,DicomPrintScuPrintManagementClassFlags).
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

DicomPrintScu Class
DicomPrintScu Members
GetPrintJobInstanceUid Method
OnPrintJobReport Method
GetLastOperationStatus Method

 

 


Products | Support | Contact Us | Copyright Notices

© 2006-2012 All Rights Reserved. LEAD Technologies, Inc.

Leadtools.Dicom requires a Medical toolkit server license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features