Windows Dev Center

INetSharingConfiguration::EnableInternetFirewall method

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

The EnableInternetFirewall methods enables Internet Connection Firewall on this connection.

Syntax


HRESULT EnableInternetFirewall();

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 enable Internet Connection Firewall to help protect your computer or network from Internet security threats. However, it may cause some of your older Internet games to function incorrectly. Do you want to turn on Internet Connection Firewall?

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

Windows XP with SP2:  Calling this API will enable the firewall on the specified interface only when Windows Firewall is enabled.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

None supported

Header

NetCon.h

DLL

Hnetcfg.dll

See also

Internet Connection Sharing and Internet Connection Firewall Reference
Internet Connection Sharing and Internet Connection Firewall Interfaces
INetSharingConfiguration

 

 

Community Additions

ADD
Show:
© 2015 Microsoft