Priority Property of the IFPCWebFilter Interface

Article
08/13/2010

The Priority property gets or sets a value from the FpcFilterPriority enumerated type that specifies the priority of the Web filter.

C++

HRESULT put_Priority(
    FpcFilterPriority FilterPriority
);
HRESULT get_Priority(
    FpcFilterPriority* pFilterPriority
);

Parameters

FilterPriority
Value from the FpcFilterPriority enumerated type that specifies the priority of the Web filter. The possible values are fpcFilterPriority_Low, fpcFilterPriority_Medium, or fpcFilterPriority_High.
pFilterPriority
Pointer to a variable that on return receives a value from the FpcFilterPriority enumerated type that specifies the priority of the Web filter. The possible values are fpcFilterPriority_Low, fpcFilterPriority_Medium, or fpcFilterPriority_High.

Return Value

These property methods return S_OK if the call is successful; otherwise, they return an error code.

Visual Basic

Property Priority As FpcFilterPriority

Property Value

Value from the FpcFilterPriority enumerated type that specifies the priority of the Web filter. The possible values are fpcFilterPriority_Low, fpcFilterPriority_Medium, or fpcFilterPriority_High.

Remarks

This property is read/write. It is initially set when the object is created by a call to the Add method of the FPCWebFilters collection.

For a Web filter to work on a Forefront TMG computer, its dynamic-link library (DLL) must be copied to the computer, an object representing it must be created in the FPCWebFilters collection for the computer's array, and it must be registered as an extension of the Forefront TMG Web proxy on the computer by including a reference to it in the computer's InstalledWebFilters property.

When an enterprise with central array management is deployed, Web filters can be added to the FPCWebFilters collections in the enterprise configuration and in array configurations. If the same Web filter is included in the FPCWebFilters collections in the enterprise configuration and an array configuration with different values for the FilterDirection property of the Web filter, the enterprise setting overrides the array setting. Conversely, the values of the RelativePath and Priority properties in the enterprise configuration are ignored.

Requirements

Client	Requires Windows 7 or Windows Vista.
Server	Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2.
Version	Requires Forefront Threat Management Gateway (TMG) 2010.
IDL	Declared in Msfpccom.idl.
DLL	Requires Msfpccom.dll.

Share via