DicomObjects.NET8 Documentation
DicomObjects Namespace / DicomGlobal Class / Echo Method

Remote entity name as IP address or resolvable name

Port to connect to

Calling Application Entity Titles (AETs)

Called Application Entity Titles (AETs)




In This Topic
    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
    'Declaration
     
    
    Public Shared Function Echo( _
       ByVal Node As String, _
       ByVal Port As Integer, _
       ByVal CallingAET As String, _
       ByVal CalledAET As String _
    ) As Integer
    'Usage
     
    
    Dim Node As String
    Dim Port As Integer
    Dim CallingAET As String
    Dim CalledAET As String
    Dim value As Integer
     
    value = DicomGlobal.Echo(Node, Port, CallingAET, CalledAET)
    public static int Echo( 
       string Node,
       int Port,
       string CallingAET,
       string CalledAET
    )
    public:
    static int Echo( 
       String^ Node,
       int Port,
       String^ CallingAET,
       String^ CalledAET
    ) 

    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)

    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.

    Requirements

    Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also