LDicomPrintSCU::Associate

#include "ltdic.h"

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

const L_TCHAR * pszPrintScuIP;

/* IP address or DNS name of the Print SCU */

L_UINT uPrintScuPort;

/* port number of the Print SCU */

const L_TCHAR * pszPrintScpIP;

/* IP address or DNS name of the Print SCP */

L_UINT uPrintScpPort;

/* port number of the Print SCP */

const L_TCHAR * pszCalledTitle;

/* Called AE Title */

const L_TCHAR * 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

pszPrintScuIP

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

uPrintScuPort

Port number of the Print SCU.

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

See Also

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

Example

For an example, refer to LDicomPrintSCU::UpdateImageBox.