IFWXSession::SetDataFilterFactory

The SetDataFilterFactory method allows a filter to set a data filter factory for events for which the filter is not registered. This method can be used to reduce the number of events for which a filter registers.

HRESULT SetDataFilterFactory(
  FwxFirewallEventType eProxyEvent,
  LPSOCKADDR Address,
  DWORD AddressLength,
  IClassFactory* pIClassFactory,
  FwxDataFilterPriorityClass PriorityClass,
  IUnknown* punkFilterContext,
  DWORD dwFlags,
  IFWXFirewallAction** ppFirewallAction
);

Parameters

eProxyEvent

The type of event for which the data filter factory is set. Can have a value from the FwxFirewallEventType enumerated type.

Address

[in] Pointer to a sockaddr structure that contains the address and port for events which should cause a data filter to be instantiated and attached. If eProxyEvent is fwx_Connect_Tcp or fwx_Udp_Destination, the address is the remote address. If eProxyEvent is fwx_Bind_Udp or fwx_AcceptedConnection, the address is the bind address. The address must be of type AF_INET, and can be either a specific IP address or INADDR_ANY.

AddressLength

[in] Length, in bytes, of the structure pointed to by the Address parameter.

pIClassFactory

[in] Pointer to a class factory for objects that support the IFWXDataFilter interface.

PriorityClass

[in] Priority class in which the data filter created will be attached. This is a value from the FwxDataFilterPriorityClass enumerated type.

punkFilterContext

[in] Pointer to an optional interface that can be used to pass context information to the data filter. This interface will be passed to IFWXDataFilter::SetSockets. This parameter can be NULL.

dwFlags

Specifies the flags for the call. Any combination of the following values is acceptable for the dwFlags parameter.

Value	Meaning
FWX_FLAG_ADDRESS_BASED	The connection for which the data filter is needed may be created by a different process by using the same address.

ppFirewallAction

[out] Address of a buffer that received a pointer to the IFWXFirewallAction interface on the proxy action object created as a result of this call. This parameter can be NULL.

Return Values

Remarks

This method is an alternative to registering to the corresponding event, comparing the address, and calling IFWXConnection::AttachDataFilter. The Microsoft Firewall service creates a data filter by using the COM IClassFactory interface, when the specified event is detected. The data filter is then attached to the appropriate connection.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wspfwext.idl.

See Also

IFWXSession