In This Topic ▼

LDicomPrintSCU::Associate

Summary

Connects to the Print SCP and then establishes the DICOM Association.

Syntax

#include "ltdic.h"

L_INT LDicomPrintSCU::Associate(pszPrintScuIP, uPrintScuPort, pszPrintScpIP, uPrintScpPort, pszCalledTitle, pszCallingTitle, uSupportedClasses)

L_INT LDicomPrintSCU::Associate(pszPrintScpIP, uPrintScpPort, pszCalledTitle, pszCallingTitle, uSupportedClasses)

Parameters

const L_TCHAR * pszPrintScuIP

Character string that contains the IP address or DNS name of the Print SCU.

L_UINT uPrintScuPort

Port number of the Print SCU.

const L_TCHAR * pszPrintScpIP

Character string that contains the IP address or DNS name of the Print SCP.

L_UINT uPrintScpPort

Port number of the Print SCP.

const L_TCHAR * pszCalledTitle

Character string that contains the Called AE Title (AE Title of the Print SCP).

const L_TCHAR * pszCallingTitle

Character string that contains the Calling AE Title (AE Title of the Print SCU).

L_UINT16 uSupportedClasses

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.

Value	Meaning
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.

Returns

Value	Meaning
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.

Comments

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.

NOTE: There is no need to call the base class functions LDicomNet::Connect and LDicomNet::Close, when using the LDicomPrintSCU class.