HRESULT Add( [in] BSTR Guid, [in] BSTR Name, [out] IFPCApplicationFilter** ppNewAppFilter );
Address of an interface pointer that on return points to the new IFPCApplicationFilter interface created.
Function Add( _ ByVal Guid As String, _ ByVal Name As String _ ) As FPCApplicationFilter
This method returns a reference to an FPCApplicationFilter object if successful. Otherwise, an error is raised that can be intercepted by using an error handler.
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.
|Client||Requires Windows Vista or Windows XP.|
|Server||Requires Windows Server 2008.|
|Version||Requires Forefront Threat Management Gateway (TMG).|
Declared in Msfpccom.idl.
Build date: 11/30/2009
© 2008 Microsoft Corporation. All rights reserved.