This topic has not yet been rated - Rate this topic

INetFwPolicy2::ExcludedInterfaces property

Specifies a list of interfaces on which firewall settings are excluded.

This property is read/write.

Syntax


HRESULT put_ExcludedInterfaces(
  [in]   NET_FW_PROFILE_TYPE2 profileType,
  [in]   VARIANT interfaces
);

HRESULT get_ExcludedInterfaces(
  [in]   NET_FW_PROFILE_TYPE2 profileType,
  [out]  VARIANT *interfaces
);

Property value

The list of interfaces.

Error codes

If the method succeeds, the return value is S_OK.

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

Name	Meaning
E_ACCESSDENIED	The operation was aborted due to permissions issues.
E_INVALIDARG	The method failed because a parameter was not valid.
E_OUTOFMEMORY	The method was unable to allocate required memory.
E_POINTER	The method failed because a pointer was not valid.

Remarks

An excluded interface is an interface to which the firewall is not applicable. The firewall is not applicable to any traffic received from or sent to an excluded interface. An empty list indicates that there are no excluded interfaces.

When you pass a profile type obtained from the CurrentProfileTypes property, make sure that you pass only one profile type to get_ExcludedInterfaces and put_ExcludedInterfaces. Note that get_CurrentProfileTypes can return multiple profiles.

Requirements

Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	Netfw.h
DLL	FirewallAPI.dll

Community Additions

ADD