IFPCEEServer::InstalledApplicationFilters property

Article
08/27/2012

Applies to: desktop apps only

The InstalledApplicationFilters property gets an FPCRefs collection that contains references to the FPCApplicationFilter objects defining the application filters installed on the server.

This property is read-only.

Syntax

HRESULT get_InstalledApplicationFilters(
  IFPCRefs **ppRefs
);

' Data type: FPCRefs

Property InstalledApplicationFilters( _
  ByVal ppRefs As IFPCRefs _
) As FPCRefs

Property value

Reference to the FPCRefs collection that contains references to the application filters installed on the server.

Error codes

This property method returns S_OK if the call is successful; otherwise, it returns an error code.

Remarks

This property is read-only. A reference to an application filter can be added by calling the Add method of the FPCRefs collection retrieved (the Add method of the IFPCRefs interface retrieved in C++) and specifying the application filter's globally unique identifier (GUID) in the Name parameter, and a reference can be removed by calling the RemoveSpecified method and specifying the application filter's GUID in the Name parameter.

In deployments with multiple Forefront TMG servers, only the application filters that are installed on a Forefront TMG computer, included in the FPCApplicationFilters collection for its array, and referenced in its InstalledApplicationFilters property are registered as installed extensions of the Microsoft Firewall service on that computer. When the Add method is called to register an application filter in an array, a reference to the new FPCApplicationFilter object is automatically added to this property of the local Forefront TMG computer.

After the collection of references has been modified, the changes must be written to persistent storage by calling the Save method, and the Microsoft Firewall service must be restarted for the changes to take effect.

Requirements

Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)
Version	Forefront Threat Management Gateway (TMG) 2010
IDL	Msfpccom.idl
DLL	Msfpccom.dll