IFWXConnection::AttachDataFilter Method

Attaches a data filter to this connection.

HRESULT AttachDataFilter(
  IFWXDataFilter *piDataFilter,
  DataFilterPriorityClass PriorityClass,
  IUnknown *punkFilterContext
);

Parameters

piDataFilter

[in] Pointer to the IFWXDataFilter interface of the Firewall service data filter object to use with this connection.

PriorityClass

[in] Priority class for the data filter. This determines the position of the data filter in relation to other data filters that may be attached to the connection. This parameter is a value from the FwxDataFilterPriorityClass enumeration.

punkFilterContext

[in] Pointer to the interface to use to pass contextual information to the data filter, such as the session to which the data filter is being attached. This interface is passed to the IFWXDataFilter::SetSockets method in the punkFilterContext parameter. This parameter can be NULL.

Remarks

This method can be called only in the context of the IFWXSessionFilter::FirewallEventHandler method while handling events with one of the following values:

fwx_AcceptedConnection

fwx_Bind_Udp

fwx_Connect_Tcp

fwx_Udp_Destination