LDicomPrintSCU::Associate

#include "ltdic.h"

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

L_CHAR L_FAR * pszPrintScpIP;	/* IP address or DNS name of the Print SCP */
L_UINT uPrintScpPort;	/* port number of the Print SCP */
L_CHAR L_FAR * pszCalledTitle;	/* Called AE Title */
L_CHAR L_FAR * pszCallingTitle;	/* Calling AE Title */
L_UINT16 uSupportedClasses;	/* supported SOP/Meta SOP Classes */

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

Parameter	Description
pszPrintScpIP	Character string that contains the IP address or DNS name of the Print SCP.
uPrintScpPort	Port number of the Print SCP.
pszCalledTitle	Character string that contains the Called AE Title (AE Title of the Print SCP).
pszCallingTitle	Character string that contains the Calling AE Title (AE Title of the Print SCU).
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

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.

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

Functions:	Class Members, LDicomPrintSCU::IsClassSupported, LDicomPrintSCU::Release, LDicomPrintSCU::GetAssociateRejectInfo, LDicomPrintSCU::GetAbortInfo, LDicomPrintSCU::SetTimeout, LDicomPrintSCU::OnStatus
Topics:	Print Management SCU
	DICOM Print Management Service Class User: Functions