#include "ltdic.h"

L_INT LDicomNet::Listen(pszHostAddress, nHostPort, nNbPeers)

L_INT LDicomNet::Listen(pszHostAddress, nHostPort, nNbPeers, nIpType)

Establishes a connection to listen for incoming connection requests. This function is available in the PACS Imaging Toolkit.


L_TCHAR * pszHostAddress

Character string that contains the IP address of the host computer (the SCP's address).

L_UINT nHostPort

Port number of the host (the SCP's port).

L_INT nNbPeers

Value passed to the WinSock listen() function for the backlog parameter that limits the size of the queue for waiting connections.

L_INT nIpType

The type of IP address.  Possible values are:

Value Meaning
DICOM_IPTYPE_NONE [0x000] Provided for initialization.
DICOM_IPTYPE_IPV4 [0x001] Only use IPv4 addresses.
DICOM_IPTYPE_IPV6 [0x002] Only use IPv6 addresses.
DICOM_IPTYPE_IPV4_OR_IPV6 [0x003] Use both IPv4 and IPv6 addresses.


Value Meaning
>0 An error occurred. Refer to Return Codes.


If pszHostAddress is " or NULL, the IP address will be the local computer's address.

If pszHostAddress 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 nHostPort is 0, the port number will be the number of the first available port.

To connect to a server as a client, you must first create and initialize a DICOM Network object using LDicomNet::LDicomNet . Then call LDicomNet::Connect to establish the connection.

To use your computer as an SCP, you must first create a DICOM Network object using LDicomNet::LDicomNet. Then call LDicomNet::Listen to listen for incoming connection requests.

The LDicomNet::Listen(pszHostAddress, nHostPort, nNbPeers, nIpType) overload allows you to specify which type of Internet Protocol Version to use.  Pass DICOM_IPTYPE_IPV4 for nIpType to support the Internet Protocol version 4 (IPv4), which is the standard  "dotted quad" 32-bit address format that has been in use since 1981. An example of an IPv4 address is

Pass DICOM_IPTYPE_IPV6 for nIpType to support Internet Protocol Version 6 (IPv6).  IPv6 uses a 128-bit address format.  An example of an IPv6 address is fe80::18bd:81f:6b02:759f

To support both IPv4 and Ipv6 addresses, pass DICOM_IPTYPE_IPV6 for nIpType.

If the call to LDicomNet::Listen()  fails, make sure that the IP address that you passed for pszHostAddress is a valid address that is accessible within your network.  Verify the accessibility of both IPv4 and IPv6 addresses using the windows ping command.  For example, to verify that is accessible within your network, perform the following steps:

  1. Launch a command prompt, and type the following command

  2. ping

The nNbPeers parameter designates the size of the backlog parameter used by the WinSock listen() function. 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 the number of connected clients and impose a maximum number of connections, perform the following steps:

  1. Use the LDicomNet::GetClientCount function in the "OnReceiveAssociateRequest" handler.

  2. Compare that value with the maximum number of connections allowed.

  3. If the number of connected clients is greater than the maximum number of connections allowed, send a "SendAssociateReject" command to the client trying to connect.

NOTE: The following are equivalent:


pDicomNet->Listen(pszHostAddr4ess, nHostPort, nNbPeers); 


pDicomNet->Listen(pszHostAddr4ess, nHostPort, nNbPeers, DICOM\_IPTYPE\_IPV4); 

Required DLLs and Libraries


Win32, x64

Help Version 21.0.2021.4.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C++ Class Library Help