Class Poco::Net::TCPServerConnectionFilter
Author: Applied Informatics Software Engineering GmbH and Contributors

# Poco::Net

# class TCPServerConnectionFilter

Library: Net
Package: TCPServer
Header: Poco/Net/TCPServer.h

## Description

A TCPServerConnectionFilter can be used to reject incoming connections before passing them on to the TCPServerDispatcher and starting a thread to handle them.

An example use case is white-list or black-list IP address filtering.

Subclasses must override the accept() method.

## Inheritance

Direct Base Classes: Poco::RefCountedObject

All Base Classes: Poco::RefCountedObject

## Member Summary

Member Functions: accept

Inherited Functions: duplicate, referenceCount, release

## Types

### Ptr

typedef Poco::AutoPtr < TCPServerConnectionFilter > Ptr;

## Destructor

### ~TCPServerConnectionFilter

virtual ~TCPServerConnectionFilter();

## Member Functions

### accept

virtual bool accept(
const StreamSocket & socket
) = 0;

Returns true if the given StreamSocket connection should be handled, and passed on to the TCPServerDispatcher.

Returns false if the socket should be closed immediately.

The socket can be prevented from being closed immediately if false is returned by creating a copy of the socket. This can be used to handle certain socket connections in a special way, outside the TCPServer framework.