L_INT LDicomPrintSCU::Associate(pszPrintScuIP, uPrintScuPort, pszPrintScpIP, uPrintScpPort, pszCalledTitle, pszCallingTitle, uSupportedClasses)
L_INT LDicomPrintSCU::Associate(pszPrintScpIP, uPrintScpPort, pszCalledTitle, pszCallingTitle, uSupportedClasses)
Connects to the Print SCP and then establishes the DICOM Association.
Character string that contains the IP address or DNS name of the Print SCU.
Port number of the Print SCU.
Character string that contains the IP address or DNS name of the Print SCP.
Port number of the Print SCP.
Character string that contains the Called AE Title (AE Title of the Print SCP).
Character string that contains the Calling AE Title (AE Title of the Print SCU).
Specifies the SOP/Meta SOP Classes supported by the Print SCU. This can be any combination of the following values. However, if none of the three Meta SOP Classes is specified, the Basic Grayscale Print Management Meta SOP Class will be specified automatically.
|PRINTSCU_BASIC_GRAYSCALE_PM_META_SOP_CLASS||[0x01] Specifies the Basic Grayscale Print Management Meta SOP Class.|
|PRINTSCU_BASIC_COLOR_PM_META_SOP_CLASS||[0x02] Specifies the Basic Color Print Management Meta SOP Class.|
|PRINTSCU_PULL_STORED_PM_META_SOP_CLASS||[0x04] Specifies the Pull Stored Print Management Meta SOP Class.|
|PRINTSCU_BASIC_ANNOTATION_BOX_SOP_CLASS||[0x08] Specifies the Basic Annotation Box SOP Class.|
|PRINTSCU_BASIC_PRINT_IMAGE_OVERLAY_BOX_SOP_CLASS||[0x10] Specifies the Basic Print Image Overlay Box SOP Class.|
|PRINTSCU_PRESENTATION_LUT_SOP_CLASS||[0x20] Specifies the Presentation LUT SOP Class.|
|PRINTSCU_PRINT_JOB_SOP_CLASS||[0x40] Specifies the Print Job SOP Class.|
|PRINTSCU_PRINTER_CONFIGURATION_RETRIEVAL_SOP_CLASS||[0x80] Specifies the Printer Configuration Retrieval SOP Class.|
|0||The Association was established successfully.|
|DICOM_ERROR_PRINTSCU_ASSOCIATE_RQ_REJECTED||The Association request was rejected by the Print SCP.|
|> 0||An error occurred. Refer to Return Codes.|
The Association must be established successfully before any of the print management operations can be performed.
This function will first try to connect to the Print SCP. If successful, it will then try to establish the Association. This function will not return until the Association is accpeted/rejected by the Print SCP, or an error occurs.
The function LDicomPrintSCU::GetAssociateRejectInfo can be used to get information about the Association rejection in case the Association request was rejected by the Print SCP.
The uSupportedClasses parameter specifies those SOP/Meta SOP Classes that are supported by the Print SCU itself. Once the Association is established, the function LDicomPrintSCU::IsClassSupported can be used to test whether a particular SOP/Meta SOP Class is supported on the Association (and hence by the Print SCP).
The established Association must be released using the function LDicomPrintSCU::Release.
Required DLLs and Libraries
For an example, refer to LDicomPrintSCU::UpdateImageBox.
Medical Web Viewer .NET
.NET, Java, Android, and iOS/macOS Assemblies
C API/C++ Class Libraries