DicomObjects Reference
DicomObjects Reference / DicomGlobal Object / EchoSecure Method
Remote entity name as IP address or resolvable name
Port to connect to
Called Application Entity Titles (AETs)
Calling and Called Application Entity Titles (AETs)

Certificate to use for user authentication

 

EchoSecure Method
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
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.
See Also