INetSharingConfiguration::get_InternetFirewallEnabled method (netcon.h)

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

The get_InternetFirewallEnabled method determines whether Internet Connection Firewall is enabled on this connection.

Syntax

HRESULT get_InternetFirewallEnabled(
  [out] VARIANT_BOOL *pbEnabled
);

Parameters

[out] pbEnabled

Pointer to a VARIANT_BOOL variable that, on successful return, specifies whether Internet Connection Firewall is enabled. If Internet Connection Firewall is enabled, this value is TRUE. Otherwise, it is FALSE.

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

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

Windows XP with SP2:   The resulting firewall status is determined by the combination of two levels: First check the global operation mode, then the mode on the interface of interest. Use the procedure Checking the Effective Firewall Status to determine the overall operational state.

Requirements

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header netcon.h
DLL Hnetcfg.dll

See also

INetSharingConfiguration

INetSharingConfiguration::DisableInternetFirewall

INetSharingConfiguration::EnableInternetFirewall

Internet Connection Sharing and Internet Connection Firewall Interfaces

Internet Connection Sharing and Internet Connection Firewall Reference