EchoSecure Method

In This Topic

Description

Secure C-ECHO

Syntax

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

Visual Basic

Public Function EchoSecure( _
   ByVal Node As String, _
   ByVal Port As Long, _
   ByVal CallingAET As String, _
   ByVal CalledAET As String, _
   ByVal Certificate As Object _
) As Long

Parameters

Node

Remote entity name as IP address or resolvable name

Port

Port to connect to

CallingAET

Called Application Entity Titles (AETs)

CalledAET

Calling and Called Application Entity Titles (AETs)

Certificate

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.