LDicomPrintSCU::Associate

#include "ltdic.h"

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

L_INT LDicomPrintSCU::Associate(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

Platforms

Win32, x64

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS DICOM C++ Class Library Help
Introduction
Version History
Getting Started
LEADTOOLS DICOM Features
Redistributables/Files To Be Included With Your Application
Quick Reference
Classes and Member Functions
CallBack Functions
Appendix