Echo Method (DicomGlobal)

In This Topic

Sends a DICOM verify (C-ECHO), with IP address, port number, callingAET, calledAET to another application entity, and returns the result

Sends a DICOM verify (C-ECHO) and returns the result

Syntax

Visual Basic
C#

'Declaration
 
Public Shared Function Echo( _
   ByVal Node As System.String, _
   ByVal Port As System.Integer, _
   ByVal CallingAET As System.String, _
   ByVal CalledAET As System.String, _
   Optional ByVal LocalIP As System.String _
) As System.Integer

public static System.int Echo( 
   System.string Node,
   System.int Port,
   System.string CallingAET,
   System.string CalledAET,
   System.string LocalIP
)

Parameters

Node: Remote entity name as IP address or resolvable name
Port: Port to connect to
CallingAET: Calling Application Entity Titles (AETs)
CalledAET: Called Application Entity Titles (AETs)
LocalIP: Optional Local IP Address to use for binding the outbound Socket

Return Value

The status provided by the SCP. This should always be 0

Remarks

Although in theory the remote entity may return a status other than 0 to indicate an error, in most circumstances (such as remote machine turned off), this method will fail with a trappable error, such as "Fail to connection at TCP level"

When certificate is used, a secure association will be attempted using TLS. If certificate is a valid x509 certificate, then user authentication will be used, but if it is null, then an anonymous client association will be attempted, which may or may not be accepted by the SCP.

Example

string node = "dicomserver.co.uk";
int port = 104;
string callingAET = "sndr";
string calledAET = "svr";
                    
var status = DicomGlobal.Echo(node, port, callingAET, calledAET);
if (status == 0)
{
    // Success
}

Requirements

Target Platforms: .NET CLR 4.8 or higher

Reference

DicomGlobal Class
DicomGlobal Members

Send Feedback