Listen(String,Int32,Int32) Method

public void Listen( 
   string hostAddress,
   int hostPort,
   int maxNumberOfPeers
)

'Declaration
 
Public Overloads Sub Listen( _
   ByVal hostAddress As String, _
   ByVal hostPort As Integer, _
   ByVal maxNumberOfPeers As Integer _
) 

'Usage
 
Dim instance As DicomNet
Dim hostAddress As String
Dim hostPort As Integer
Dim maxNumberOfPeers As Integer
 
instance.Listen(hostAddress, hostPort, maxNumberOfPeers)

public void Listen( 
   string hostAddress,
   int hostPort,
   int maxNumberOfPeers
)

ObjectiveC Syntax

 function Leadtools.Dicom.DicomNet.Listen(String,Int32,Int32)( 
   hostAddress ,
   hostPort ,
   maxNumberOfPeers 
)

public:
void Listen( 
   String^ hostAddress,
   int hostPort,
   int maxNumberOfPeers
) 

Parameters

hostAddress

The IP address of the host computer (the SCP's address).

hostPort

The port number of the host computer (the SCP's port).

maxNumberOfPeers

Backlog parameter.

If hostAddress is an empty string or a null reference (Nothing in Visual Basic), the IP address will be the local computer's address.

If hostAddress is "*", the IP address will be all of the local computer's addresses. This is useful if the local computer has more than one network interface and address.

If hostPort is 0, the port number will be the number of the first available port.

The maxNumberOfPeers parameter is the value passed to the WinSock listen() function for the backlog parameter that limits the size of the queue for waiting connections. As an example, suppose that the value is set to 3 and that 4 people try to connect at exactly the same time. In such a case, all 4 will be rejected because the connection backlog queue is full. But if one of the connections has been accepted by the time the 4th is made, then all will work.

To determine how many clients are connected and impose a limit on the number of connections, perform the following steps:

1. Use the DicomNet.GetClientCount function in the "OnReceiveAssociateRequest" handler.
2. Compare that value with the maximum number of connections allowed.
3. If the number of clients connected is greater than the maximum number of connections allowed, send a "SendAssociateReject" command to the client trying to connect.

To connect to a server as a client, you must first create and initialize a DicomNet object. Then call Connect(String,Int32,String,Int32) to establish the connection.

To use your computer as an SCP, you must first create a DicomNet object. Then call Listen(String,Int32,Int32) to listen for incoming connection requests.

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

Reference

DicomNet Class
DicomNet Members
Overload List
Startup Method
Connect(String,Int32,String,Int32) Method