ReloadConfiguration Method of the IFWXPolicyChangeNotification Interface

The ReloadConfiguration method receives a notification from the Microsoft Firewall service that changes to the configuration of the Forefront TMG administration COM objects have been applied in a call to a Save method with the fReloadConfiguration parameter set to VARIANT_TRUE and can perform user-defined operations to reload the saved configuration of the Forefront TMG administration COM objects from persistent storage.

Syntax

HRESULT ReloadConfiguration();

Parameters

This method has no parameters.

Return Value

The implementation of this method should return S_OK if the reloading operation succeeds or any valid Windows error code if reloading of any part of the configuration fails.

Remarks

A call to a Save method with the fReloadConfiguration parameter set to VARIANT_TRUE ensures only that configuration changes that can be applied dynamically without restarting services take effect. Changes that require restarting of the Firewall service are applied during a call to a Save method only if the fResetRequiredServices parameter is set to VARIANT_TRUE. For more information, see Restarting Services After Configuration Changes.

The Firewall service notifies multiple application filters one-by-one after it has reloaded the saved configuration with the most recent changes from persistent storage to the Forefront TMG services.

Calls to the ReloadConfiguration method are serialized with calls to the FilterInit and FilterShutdown methods of the filter.

When a Save method is invoked because the user pressed the Apply button in Forefront TMG Management and the ReloadConfiguration method returns an error, the Firewall service will display a message to the user in Forefront TMG Management, indicating that the reload operation failed and directing the user to look in the event log for details about the failure. It is the responsibility of the application filter to write the error code and a specific description in the event log with details about the part of the configuration that failed to reload.

Requirements

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

Declared in Wspfwext.idl.

See Also

IFWXPolicyChangeNotification


Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.