[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 code | Description |
|---|
- 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 |
|---|
| 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
Send comments about this topic to Microsoft
Build date: 10/8/2009