IFWXFilter::FilterInit Method

Initializes the filter and passes it an interface pointer to the Firewall service object. The Firewall service object provides general methods to the filter. For a list of the general methods see IFWXFirewall, the interface for the Firewall service object.

HRESULT FilterInit(
  IFWXFirewall *pIFWXFirewall,
  PFilterHookEvents *ppFilterHookEvents
);

Parameters

pIFWXFirewall

[in] Pointer to the IFWXFirewall interface on the firewall service. IFWXFirewall provides access to proxy services.

ppFilterHookEvents

[out] Pointer to a PFilterHookEvents variable. This must be set to refer to a FwxFilterHookEvents structure containing the initial set of events that the filter monitors. Use the CoTaskMemAlloc function to allocate the structure. IFWXFirewall::DuplicateFilterHookEvents creates a duplicate of the FwxFilterHookEvents structure in a buffer which can be returned by IFWXFilter::AttachToSession.

Return Values

S_OK

The connection will be denied.

FAILED

The connection is aborted.

Remarks

Place in FilterInit all initializations, particularly events to monitor, as well as the reading of configurations and the creation of listening sockets.

See Also

IFWXFirewall::DuplicateFilterHookEvents