IFWXIpFilter::IsIncluded Method

Checks if a particular IP address is included in the ranges of those allowed by the IP filter.

HRESULT IsIncluded(
  IN_ADDR IP
);

Parameters

IP

IP address to check.

Return Values

S_OK

The address is included.

S_FALSE

The address is not included.

Remarks

Based on the value returned by IFWXIpFilter::IsIncluded, you can decide whether to initiate a connection. There is no automatic effect upon the connection. For example, you may use this method in the following way:

1. Call IFWXConnection::GetIpFilter on a connection object, such as a listening connection object.
2. Use IFWXIpFilter::IsIncluded to check if a specific IP address is included in the ranges specified by the filter.
3. If the address is not included in the range, you can decide to not initiate the connection.