IFWXLowResourceRecoverer Interface

The IFWXLowResourceRecoverer interface is the application filter interface that registers and unregisters an application filter for low resource recovery operations, and signals when a low resource recovery failure occurs. For a description of the low resource recovery process, see the Remarks section of this topic.

Syntax

interface IFWXLowResourceRecoverer : IUnknown

Methods

The IFWXLowResourceRecoverer interface inherits the methods of the IUnknown interface.

In addition, IFWXLowResourceRecoverer defines the following methods.

Method Description

RegisterForLowResourceRecovery

Registers an application filter for low resource recovery operations.

UnregisterFromLowResourceRecovery

Unregisters an application filter from a low resource recovery operation.

SignalLowResourceFailure

Signals the Microsoft Firewall service that a failure related to low resources has occurred.

Remarks

To use the low resource recovery mechanism, your filter has to register with the Firewall service using the IFWXLowResourceRecoverer::RegisterForLowResourceRecovery method so that the filter will handle failures. When a failure occurs, the filter can check the error message to ascertain whether the failure was caused by low resource availability. If so, the filter has to call the IFWXLowResourceRecoverer::SignalLowResourceFailure method, providing a cookie identifying the failure, and indicating to the Firewall service that the filter wants to recover from the failure. The Firewall service then calls the IFWXLowResourceRecoveryOperation::Recover method, which can retry the operation periodically until it succeeds.

Requirements

Server Requires Windows Server 2008.
Version Requires Forefront Threat Management Gateway (TMG).
Header

Declared in Wspfwext.idl.

See Also

Filter Interfaces


Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.