IltmsIPFilters::Add

#include "ltms.h"

C Syntax	HRESULT IltmsIPFilters_Add(pIPFilters, ipfirst, iplast, allow)
C++ Syntax	HRESULT Add(ipfirst, iplast, allow)

IltmsIPFilters *pIPFilters;	pointer to an interface
BSTR ipfirst;	first IP address
BSTR iplast;	last IP address
VARIANT_BOOL allow;	boolean value

Adds an IP Filter to the collection.

Parameter	Description
pIPFilters	Pointer to an IltmsIPFilters interface.
ipfirst	String containing the starting IP address of the IP filter (inclusive).
iplast	String containing the ending IP address of the IP filter (inclusive).
allow	Boolean value that indicates whether to allow connections in the specified IP address range.
	Value
	VARIANT_TRUE
	VARIANT_FALSE

Returns

S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

When you add an IP filter it is combined with the existing filters in the collection. The resulting collection is always a normalized list covering the complete IP address range. Call IltmsIPFilters::get_Count to obtain the resulting collection's IP filter count.

Required DLLs and Libraries

LTMS

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

Example

For a C++ example, refer to Set Local Network Filter Example for C++.

Help Version 19.0.2017.10.27

Elements:	IltmsIPFilters Interface, IltmsIPFilters::get_Count
Topics:	Media Streaming Function Groups