Returns the handle of HNUserFilter object.

Syntax:

HANDLE __stdcall FAdpGetUserFilter(HANDLE hFAdp);

Parameters:

hFAdp

[in] HNFileAdapter object handle.

Return values:

If the function succeeds the return value will be the HNUserFilter handle, otherwise the return value will be NULL.

Description:

Use FAdpGetUserFilter to get BPF value for current CAP file.

BPF filters may be used for filtering packets read from a CAP file by FAdpGetNextPacket function, also they will be used by HNFileAdpater object in AutoMode. At the same time the BPF statistics will be counted (see FAdpGetRecvCount, FAdpGetAcceptCount, FAdpGetRejectCount, FAdpGetProcessCount).

To set BPF filter please use FAdpSetUserFilter function.

Please remember, that UserFilter must be used with UserFilterActive property.