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

© 2008 Microsoft Corporation. All rights reserved.

[an error occurred while processing this directive]