SourcePro® 2024.1 |
SourcePro® API Reference Guide |
Waits on a specified socket address for incoming connections. More...
#include <rw/network/RWSocketListener.h>
Public Member Functions | |
RWSocketListener () | |
RWSocketListener (const RWSockAddrBase &address, int backlog=5) | |
RWSocketListener (const RWSocket &socket, WhoShouldClose who=Portal) | |
~RWSocketListener () | |
RWSocketPortal | accept (RWSockAddr *addr=0) const |
RWSocket | getSocket () const |
void | listen (const RWSockAddrBase &address, int backlog=5) |
RWSocketPortal | operator() (RWSockAddr *addr=0) const |
Additional Inherited Members | |
Public Types inherited from RWSocketPortalBase | |
enum | WhoShouldClose { Portal , Application } |
Waits on a specified socket address for incoming connections. Connections are obtained as RWSocketPortal instances.
RWSocketListener::RWSocketListener | ( | ) |
Creates an uninitialized socket listener. Self
needs to be initialized using listen() before it can be used.
RWSocketListener::RWSocketListener | ( | const RWSockAddrBase & | address, |
int | backlog = 5 ) |
Sets up a listener on the address indicated, and sets up a queue to wait for connections. The backlog parameter specifies the number of incoming connection requests that the protocol software enqueues while a connection is being processed.
SO_REUSEADDR
option on the socket. If you do not want this option to be set, pass an initalized socket to RWSocketListener(const RWSocket&,WhoShouldClose). See section "Socket
Security" under Chapter 8, "The Windows Socket Adapter" in the Essential Networking Module User's Guide for more information. RWSocketListener::RWSocketListener | ( | const RWSocket & | socket, |
WhoShouldClose | who = Portal ) |
Creates a listening portal to the communications channel, where socket is the socket doing the listening. Using this constructor is the only way to create a socket that is not closed automatically when portals are no longer using it.
RWSocketListener::~RWSocketListener | ( | ) |
Destructor.
RWSocketPortal RWSocketListener::accept | ( | RWSockAddr * | addr = 0 | ) | const |
Receives the next waiting connection. The address of the connecting client will be stored in the RWSockAddr referenced by addr.
RWSocket RWSocketListener::getSocket | ( | ) | const |
Obtains a reference to the underlying socket.
void RWSocketListener::listen | ( | const RWSockAddrBase & | address, |
int | backlog = 5 ) |
Binds the listener to the address indicated, and sets up a queue to wait for connections. The backlog parameter specifies the number of incoming connection requests that the protocol software enqueues while a connection is being processed.
SO_REUSEADDR
option on the socket. If you do not want this option to be set, pass an initalized socket to RWSocketListener(const RWSocket&,WhoShouldClose). See section "Socket
Security" under Chapter 8, "The Windows Socket Adapter" in the Essential Networking Module User's Guide for more information. RWSocketPortal RWSocketListener::operator() | ( | RWSockAddr * | addr = 0 | ) | const |
Receives the next waiting connection. The address of the connecting client will be stored in the RWSockAddr referenced by addr.
Copyright © 2024 Rogue Wave Software, Inc., a Perforce company. All Rights Reserved. |