Associate(string,int,string,int,string,string,DicomPrintScuPrintManagementClassFlags) Method

Summary

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

Syntax

C++

public bool Associate( 
   string printScuIP, 
   int printScuPort, 
   string printScpIP, 
   int printScpPort, 
   string calledTitle, 
   string callingTitle, 
   DicomPrintScuPrintManagementClassFlags supportedClasses 
)

Public Overloads Function Associate( _ 
   ByVal printScuIP As String, _ 
   ByVal printScuPort As Integer, _ 
   ByVal printScpIP As String, _ 
   ByVal printScpPort As Integer, _ 
   ByVal calledTitle As String, _ 
   ByVal callingTitle As String, _ 
   ByVal supportedClasses As DicomPrintScuPrintManagementClassFlags _ 
) As Boolean

public: 
bool Associate(  
   String^ printScuIP, 
   int printScuPort, 
   String^ printScpIP, 
   int printScpPort, 
   String^ calledTitle, 
   String^ callingTitle, 
   DicomPrintScuPrintManagementClassFlags supportedClasses 
)

Parameters

printScuIP
The IP address or DNS name of the Print SCU. If this parameter is a null reference (Nothing in VB), the IP address will be that of the local computer.

printScuPort
Port number of the Print SCU. If this parameter is 0, the port number will be that of the first available port.

printScpIP
The IP address or DNS name of the Print SCP.

printScpPort
Port number of the Print SCP.

calledTitle
The Called AE Title (AE Title of the Print SCP).

callingTitle
The Calling AE Title (AE Title of the Print SCU).

supportedClasses
The SOP/Meta SOP Classes supported by the Print SCU. If none of the Meta SOP Classes is specified, the Basic Grayscale Print Management Meta SOP Class will be specified automatically.

Return Value

true if the Association was established successfully; false if the Association request was rejected by the Print SCP.

Remarks

The Association must be established successfully before any of the print management operations can be performed. This method will first try to connect to the Print SCP. If successful, it will then try to establish the Association. This method will not return until the Association is accepted/rejected by the Print SCP, or an error occurs.

The method GetAssociateRejectInformation can be used to get information about the Association rejection in case the Association request was rejected by the Print SCP.

The supportedClasses parameter specifies those SOP/Meta SOP Classes that are supported by the Print SCU itself. Once the Association is established, the method 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 can be released using the method Release. It can also be aborted using the method Abort.

Example

For an example, refer to Associate.

Requirements

Target Platforms