IsIncluded Method of the IFWXIpFilter Interface

The IsIncluded method checks if a particular IP address is included in the ranges of those allowed by the IP filter.

Syntax

HRESULT IsIncluded(
	IN_ADDR IP
);

Parameters

IP

IP address to check.

Return Value

S_OK

The address is included.

S_FALSE

The address is not included.

Remarks

Based on the value returned by the IFWXIpFilter::IsIncluded method, 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 the IFWXConnection::GetIpFilter method on a connection object, such as a listening connection object.
2. Use the IFWXIpFilter::IsIncluded method 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 not to initiate the connection.

Requirements

Server	Requires Windows Server 2008.
Version	Requires Forefront Threat Management Gateway (TMG).
Header	Declared in Wspfwext.idl.
DLL	Requires Wspsrv.exe.

See Also

IFWXIpFilter

Send comments about this topic to Microsoft

Build date: 11/30/2009