DicomObjects Reference
DicomObjects Reference / DicomGlobal Object / Echo Method
Remote entity name as IP address or resolvable name
Port to connect to
Calling and Called Application Entity Titles (AETs)
Certificate to use for user authentication
Echo Method
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
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.
See Also