INetSharingConfiguration::DisableInternetFirewall method

[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

This method has no 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.

Return codeDescription
E_ABORT

The operation was stopped.

E_FAIL

An unspecified error occurred.

E_INVALIDARG

One of the parameters is not valid.

E_NOINTERFACE

A specified interface is not supported.

E_NOTIMPL

A specified method is not implemented.

E_OUTOFMEMORY

The method was unable to allocate required memory.

E_POINTER

A pointer passed as a parameter is not valid.

E_UNEXPECTED

The method failed for unknown reasons.

 

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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

None supported

Header

NetCon.h

DLL

Hnetcfg.dll

See also

INetSharingConfiguration
INetSharingConfiguration::EnableInternetFirewall
INetSharingConfiguration::get_InternetFirewallEnabled

 

 

Show: