Add Method of the IFPCApplicationFilters Interface

The Add method creates a new FPCApplicationFilter object in the collection and returns a reference to it.

HRESULT Add(
  [in]   BSTR Guid,
  [in]   BSTR Name,
  [out]  IFPCApplicationFilter** ppNewAppFilter
);

Function Add( _
  ByVal Guid As String, _
  ByVal Name As String _
) As FPCApplicationFilter

Remarks

For an application filter to work on a Forefront TMG computer, its dynamic-link library (DLL) and other necessary files must be copied to the computer, an object representing it must be created in the FPCApplicationFilters collection for the computer's array, and it must be registered as an extension of the Microsoft Firewall service on the computer by including a reference to it in the computer's InstalledApplicationFilters property. When the Firewall service starts, it creates an instance of the filter object for each application filter that is registered on the Forefront TMG computer and enabled.

When the Add method is called on an array member to register an application filter in an array, a reference to the new FPCApplicationFilter object is automatically created in the FPCRefs collection held in the InstalledApplicationFilters property of the local Forefront TMG computer. The Add method should not be called on two members of the same array simultaneously.

When an enterprise with central array management is deployed, objects representing application filters can be added to the FPCApplicationFilters collection in the enterprise configuration. Creating an object for an application filter in the enterprise FPCApplicationFilters collection is optional, but provides several benefits.

When an enterprise with central array management is deployed, the Add method can be used to add an application filter to the configuration of an empty array.

For more information about registering application filters, see Filter Setup.

Requirements

See Also

FPCApplicationFilters

Send comments about this topic to Microsoft

Build date: 11/30/2009