IFWXPolicyChangeNotification::ReloadConfiguration method

Article
08/27/2012

Applies to: desktop apps only

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

Minimum supported client	None supported
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)
Version	Forefront Threat Management Gateway (TMG) 2010
Header	Wspfwext.idl