Leadtools.Dicom Requires Medical product license | Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.10.31
Associate(String,Int32,String,Int32,String,String,DicomPrintScuPrintManagementClassFlags) Method
See Also 
Leadtools.Dicom Namespace > DicomPrintScu Class > Associate Method : Associate(String,Int32,String,Int32,String,String,DicomPrintScuPrintManagementClassFlags) Method




printScuIP
The IP address or DNS name of the Print SCU. If this parameter is a null reference (Nothing in Visual Basic), 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.
Connects to the Print SCP and then establishes the DICOM Association.

Syntax

Visual Basic (Declaration) 
Overloads Public 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
Visual Basic (Usage)Copy Code
Dim instance As DicomPrintScu
Dim printScuIP As String
Dim printScuPort As Integer
Dim printScpIP As String
Dim printScpPort As Integer
Dim calledTitle As String
Dim callingTitle As String
Dim supportedClasses As DicomPrintScuPrintManagementClassFlags
Dim value As Boolean
 
value = instance.Associate(printScuIP, printScuPort, printScpIP, printScpPort, calledTitle, callingTitle, supportedClasses)
Managed Extensions for C++ 
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 Visual Basic), 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.

Example

For an example, refer to Associate.

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 accpeted/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.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Leadtools.Dicom requires a Medical toolkit license and unlock key. For more information, refer to: Raster Pro/Document/Medical Features