Echo Method

In This Topic

Description

send a C-ECHO request

Syntax

Visual Basic
Public Function Echo( _ ByVal Node As String, _ ByVal Port As Long, _ ByVal CallingAET As String, _ ByVal CalledAET As String _ ) As Long

Visual Basic

Public Function Echo( _
   ByVal Node As String, _
   ByVal Port As Long, _
   ByVal CallingAET As String, _
   ByVal CalledAET As String _
) As Long

Parameters

Node: Remote entity name as IP address or resolvable name
Port: Port to connect to
CallingAET: Calling and Called Application Entity Titles (AETs)
CalledAET: Certificate to use for user authentication

Remarks

These methods are easier to use than the previously available DicomConnection.SendVerify method, but unlike the SendVerify method, these methods are always synchronous.
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 “Failed to connect at TCP level”.
When EchoSecure 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.