Microsoft Internet Security and Acceleration Server 2004 SDK

IFWXPolicyChangeNotification::ReloadConfiguration

The ReloadConfiguration method receives a notification from the Microsoft Firewall service that changes to the configuration of the ISA Server 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 ISA Server administration COM objects from persistent storage.

HRESULT ReloadConfiguration();

Parameters

This method has no parameters.

Return Values

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 ISA Server 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 ISA Server Management and the ReloadConfiguration method returns an error, the Firewall service will display a message to the user in ISA Server 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 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wspfwext.idl.

See Also

IFWXPolicyChangeNotification