[Internet Connection Firewall may be altered or unavailable in subsequent versions. Instead, use the Windows Firewall API.]

The DisableInternetFirewall method disables Internet Connection Firewall on this connection.

Syntax

HRESULT DisableInternetFirewall();

Parameters

Return Value

If the method succeeds the return value is S_OK.

If the method fails, the return value is one of the following error codes.

Remarks

Calling this method triggers the following notification:

%programname% is attempting to disable your Internet Connection Firewall. This makes your computer more vulnerable to Internet security threats. Do you want to allow %programname% to disable Internet Connection Firewall?

This method returns successfully even if Internet Connection Firewall was not enabled on this connection.

Use the INetSharingManager::get_INetSharingConfigurationForINetConnection method to obtain an INetSharingConfiguration interface for a particular connection.

Windows XP with SP2:  Calling this API will disable the firewall on the specified interface, regardless of whether the Windows Firewall is on.

Requirements

See Also

INetSharingConfiguration

INetSharingConfiguration::EnableInternetFirewall

INetSharingConfiguration::get_InternetFirewallEnabled

Send comments about this topic to Microsoft

Build date: 10/8/2009