Firewall Objects

These Inspectors retrieve the various firewall settings for the BES Client computer.

firewall

The Firewall Inspectors allow you to view the settings of the Windows Firewall on Windows Clients. By inspecting the firewall properties, you can determine which applications have access to unsolicited traffic and how the firewall is configured for various subsets of your network. The Windows Firewall is supported on Windows XP SP2. For more information, search for 'Windows Firewall API' at the MSDN site (http://msdn.microsoft.com/library/).

Creation Methods

Declaration	Description	Platforms (?)
firewall	Returns the global firewall object for this computer.	Win

Properties

Declaration	Return type	Description	Platforms (?)
current profile type of <firewall>	<firewall profile type> Plural: current profile types	Returns the current profile type, corresponding to the Microsoft Windows Firewall enumerated type: NET_FW_PROFILE_TYPE.	Win
local policy modify state of <firewall>	<firewall local policy modify state> Plural: local policy modify states	Determines if adding or setting a rule or group of rules will take effect in the specified firewall profile. For more information, see the MSDN Library entry for INetFwPolicy2.	Win
local policy of <firewall>	<firewall policy> Plural: local policies	Returns the local policy of the specified firewall.	Win
profile type of <firewall>	<firewall profile type> Plural: profile types		Win:8.2
rule group currently enabled <string> of <firewall>	<boolean> Plural: rule group currently enableds	Determines whether a specified group of firewall rules is enabled or disabled for the current profile, considering the firewall's state, BlockAllInboundTraffic state and group policy overrides state. The string is used to group rules together. It can be the group name or an indirect string to the group name in the form of "@yourresourcedll.dll,-23255." Rules belonging to this group will be queried.	Win
rule of <firewall>	<firewall rule> Plural: rules	Retrieves the collection of rules for the specified firewall. For more information, see the MSDN Library article on INetFwPolicy2.	Win
service restriction of <firewall>	<firewall service restriction> Plural: service restrictions	Retrieves the access interface to manipulate the Windows Service Hardening store. On Windows operating systems earlier than Vista, this Inspector always returns no-such-object. For more information, see the MSDN Library entry for INetFwPolicy2.	Win

firewall authorized application

The <firewall authorized application> Inspectors apply to applications that are authorized to exchange traffic through the Windows Firewall. These properties correspond to the INetFwAuthorizedApplication interface in the Windows Firewall API. The Windows Firewall is supported on Windows XP SP2. For more information, search for 'Windows Firewall API' at the msdn site (http://msdn.microsoft.com/library/).

Creation Methods

Declaration	Description	Platforms (?)
authorized application of <firewall profile>	Access to the AuthorizedApplications collection for this profile. This Inspector can be iterated through all the authorized applications in each firewall profile.	Win

Properties

Declaration	Return type	Description	Platforms (?)
enabled of <firewall authorized application>	<boolean> Plural: enableds	Returns the contents of the Enabled property for the specified application. Returns TRUE if the settings for this application are currently enabled.	Win
ip version of <firewall authorized application>	<ip version> Plural: ip versions	Returns the contents of the IpVersion property for the specified application.	Win
name of <firewall authorized application>	<string> Plural: names	Returns the contents of the Friendly Name property for the specified application.	Win
process image file name of <firewall authorized application>	<string> Plural: process image file names	Returns the contents of the ProcessImageFileName property for the specified application.	Win
remote addresses of <firewall authorized application>	<string> Plural: remote addresseses	Returns the contents of the RemoteAddresses property for the specified application. This property accesses a set of remote addresses that an application can use to listen for traffic.	Win
scope of <firewall authorized application>	<firewall scope> Plural: scopes	Returns the contents of the Scope property for the specified application. This property controls the network scope that a port can listen to.	Win

firewall profile

The <firewall profile> Inspectors provide access to the firewall profile. These properties correspond to the INetFwProfile interface in the Windows Firewall API. For more information, search for 'Windows Firewall API' at the msdn site (http://msdn.microsoft.com/library/).

Creation Methods

Declaration	Description	Platforms (?)
current profile of <firewall policy>	Returns the profile currently in effect for the specified firewall policy.	Win
domain profile of <firewall policy>	Returns the domain profile of the specified firewall policy. The domain profile settings are used when a computer is connected to a network that contains the organization's domain controllers. For more information, see the MSDN Library entry for NET_FW_PROFILE_TYPE2.	Win
private profile of <firewall policy>	Retrieves the private profile type from the specified firewall policy. This profile type is used for home and other private network types. For more information, see the MSDN Library entry for NET_FW_PROFILE_TYPE2.	Win
profile of <firewall policy>		Win:8.2
public profile of <firewall policy>	Retrieves the public profile type from the specified firewall policy. For more information, see the MSDN Library entry for NET_FW_PROFILE_TYPE2.	Win
standard profile of <firewall policy>	Returns the standard profile of the specified firewall policy. The standard profile settings are used when a computer is connected to a network that does not contain the organization's domain controllers. This Inspector corresponds to the Microsoft Windows Firewall enumerated type NET_FW_PROFILE_STANDARD.	Win

Properties

Declaration	Return type	Description	Platforms (?)
authorized application of <firewall profile>	<firewall authorized application> Plural: authorized applications	Access to the AuthorizedApplications collection for this profile. This Inspector can be iterated through all the authorized applications in each firewall profile.	Win
exceptions allowed of <firewall profile>	<boolean> Plural: exceptions alloweds	Returns the property that indicates whether exceptions should be allowed by the firewall.	Win
excluded interface of <firewall profile>	<string> Plural: excluded interfaces	Gets the value of the ExcludedInterfaces property from the specified firewall profile. This property contains the list of interfaces excluded from a the profile's firewall rules. For more information, see the MSDN Library entry for INetFwPolicy2.	Win
firewall enabled of <firewall profile>	<boolean> Plural: firewalls enabled	Gets the value of the FirewallEnabled setting.	Win
globally open port of <firewall profile>	<firewall open port> Plural: globally open ports	Provides access to the GloballyOpenPorts collection for this profile. This property can be iterated.	Win
icmp settings of <firewall profile>	<firewall icmp settings> Plural: icmp settingses	Gets the object governing settings for ICMP packets.	Win
inbound connections allowed of <firewall profile>	<boolean> Plural: inbound connections alloweds	Determines whether the default action for inbound traffic for the specified firewall profile is NET_FW_ACTION_ALLOW. For more information, see the MSDN Library entry for INetFwPolicy2.	Win
notifications disabled of <firewall profile>	<boolean> Plural: notifications disableds	Gets the value of the NotificationsDisabled setting, TRUE or FALSE.	Win
outbound connections allowed of <firewall profile>	<boolean> Plural: outbound connections alloweds	Determines whether the default action for outbound traffic for the specified firewall profile is NET_FW_ACTION_ALLOW. For more information, see the MSDN Library entry for INetFwPolicy2.	Win
remote admin settings of <firewall profile>	<firewall remote admin settings> Plural: remote admin settingses	Gets the object containing the remote administration settings.	Win
rule group enabled <string> of <firewall profile>	<boolean> Plural: rule group enableds	Determines whether a specified group of firewall rules are enabled or disabled. For more information, see the MSDN Library entry for INetFwPolicy2.	Win
service of <firewall profile>	<firewall service> Plural: services	Gets the collection containing the services for this profile. This Inspector can be iterated over all services.	Win
type of <firewall profile>	<firewall profile type> Plural: types	Returns the type of the specified firewall profile: domain, standard or current.	Win
unicast responses to multicast broadcast disabled of <firewall profile>	<boolean> Plural: unicast responses to multicast broadcast disableds	Gets the value of the UnicastResponsesToMulticastBroadcastDisabled setting.	Win

firewall profile type

The <firewall profile type> Inspectors provide access to the firewall profile type. The Windows Firewall is supported on Windows XP SP2. For more information, search for 'Windows Firewall API' at the msdn site (http://msdn.microsoft.com/library/).

Creation Methods

Declaration	Description	Platforms (?)
current firewall profile type	Retrieves the type of firewall profile that is currently in effect.	Win
domain firewall profile type	Creates a domain firewall profile type for comparison.	Win
firewall profile type <integer>	Returns the firewall profile type corresponding to the given integer:0: Domain1: Standard2: Current. Example: current firewall profile type = firewall profile type 3 - Returns TRUE. Example: current profile type of firewall = standard firewall profile type - Returns TRUE if the current profile type is standard.	Win
private firewall profile type	Retrieves the enumerated variable corresponding to private profile type. For more information, see the MSDN Library entry for NET_FW_PROFILE_TYPE2.	Win
public firewall profile type	Retrieves the enumerated variable corresponding to public profile type. This profile type is used for public internet access points. For more information, see the MSDN Library entry for NET_FW_PROFILE_TYPE2.	Win
standard firewall profile type	Returns the Standard firewall profile type. This is a global property.	Win
current profile type of <firewall>	Returns the current profile type, corresponding to the Microsoft Windows Firewall enumerated type: NET_FW_PROFILE_TYPE.	Win
profile type of <firewall>		Win:8.2
type of <firewall profile>	Returns the type of the specified firewall profile: domain, standard or current.	Win

Operators

Declaration	Return Type	Description	Platforms (?)
<firewall profile type> = <firewall profile type>	<boolean>	Compares two firewall policies for equality only.	Win

Properties

Declaration	Return type	Description	Platforms (?)
<firewall profile type> as string	<string>		Win:8.2

firewall policy

The <firewall policy> Inspectors provide access to the local, current, domain and standard firewall policies. These properties correspond to the INetFwPolicy interface in the Windows Firewall API. The Windows Firewall is supported on Windows XP SP2. For more information, search for 'Windows Firewall API' at the msdn site (http://msdn.microsoft.com/library/).

Creation Methods

Declaration	Description	Platforms (?)
local policy of <firewall>	Returns the local policy of the specified firewall.	Win

Properties

Declaration	Return type	Description	Platforms (?)
current profile of <firewall policy>	<firewall profile> Plural: current profiles	Returns the profile currently in effect for the specified firewall policy.	Win
domain profile of <firewall policy>	<firewall profile> Plural: domain profiles	Returns the domain profile of the specified firewall policy. The domain profile settings are used when a computer is connected to a network that contains the organization's domain controllers. For more information, see the MSDN Library entry for NET_FW_PROFILE_TYPE2.	Win
private profile of <firewall policy>	<firewall profile> Plural: private profiles	Retrieves the private profile type from the specified firewall policy. This profile type is used for home and other private network types. For more information, see the MSDN Library entry for NET_FW_PROFILE_TYPE2.	Win
profile of <firewall policy>	<firewall profile> Plural: profiles		Win:8.2
public profile of <firewall policy>	<firewall profile> Plural: public profiles	Retrieves the public profile type from the specified firewall policy. For more information, see the MSDN Library entry for NET_FW_PROFILE_TYPE2.	Win
standard profile of <firewall policy>	<firewall profile> Plural: standard profiles	Returns the standard profile of the specified firewall policy. The standard profile settings are used when a computer is connected to a network that does not contain the organization's domain controllers. This Inspector corresponds to the Microsoft Windows Firewall enumerated type NET_FW_PROFILE_STANDARD.	Win

firewall scope

The <firewall scope> Inspectors provide access to the firewall scope. The Windows Firewall is supported on Windows XP SP2. For more information, search for 'Windows Firewall API' at the msdn site (http://msdn.microsoft.com/library/).

Creation Methods

Declaration	Description	Platforms (?)
all firewall scope	Returns the scope of computers that allow ALL traffic through the firewall, corresponding to the Microsoft enumerated type NET_FW_SCOPE_ALL.	Win
custom firewall scope	Returns the custom firewall scope, corresponding to the Microsoft enumerated type: NET_FW_SCOPE_CUSTOM.	Win
firewall scope <integer>	Returns the scope of addresses from which a port can listen.	Win
local subnet firewall scope	Returns the local subnet firewall scope, corresponding to the Microsoft enumerated type: NET_FW_SCOPE_LOCAL_SUBNET.	Win
scope of <firewall authorized application>	Returns the contents of the Scope property for the specified application. This property controls the network scope that a port can listen to.	Win
scope of <firewall open port>	Returns the Scope property of the firewall open port.	Win
scope of <firewall service>	Retrieves the contents of the Scope property of the firewall service.	Win

Operators

Declaration	Return Type	Description	Platforms (?)
<firewall scope> = <firewall scope>	<boolean>	Compares two firewall scopes for equality only.	Win

Properties

Declaration

Return type

Description

Platforms (?)

firewall open port

The <firewall open port> Inspectors provide access to the properties of a port that has been opened in the Windows Firewall. These properties correspond to the INetFwOpenPort interface in the Windows Firewall API. The Windows Firewall is supported on Windows XP SP2. For more information, search for 'Windows Firewall API' at the msdn site (http://msdn.microsoft.com/library/).

Creation Methods

Declaration	Description	Platforms (?)
globally open port of <firewall profile>	Provides access to the GloballyOpenPorts collection for this profile. This property can be iterated.	Win
globally open port of <firewall service>	Returns the collection of globally open ports associated with the firewall service. Example: exists globally open port whose (port of it = 52311 and protocol of it = udp and enabled of it) of current profile of local policy of firewall - Returns TRUE if the BES Client can receive pings.	Win

Properties

Declaration	Return type	Description	Platforms (?)
built in of <firewall open port>	<boolean> Plural: built ins	Returns the contents of the BuiltIn property of the firewall open port.	Win
enabled of <firewall open port>	<boolean> Plural: enableds	Returns the contents of the Enabled property of the firewall open port.	Win
ip version of <firewall open port>	<ip version> Plural: ip versions	Returns the IpVersion property of the firewall open port.	Win
name of <firewall open port>	<string> Plural: names	Returns the Name property of the firewall open port.	Win
port of <firewall open port>	<integer> Plural: ports	Returns the Port property of the firewall open port.	Win
protocol of <firewall open port>	<internet protocol> Plural: protocols	Returns the Protocol property of the firewall open port.	Win
remote addresses of <firewall open port>	<string> Plural: remote addresseses	Returns the RemoteAddresses property of the firewall open port.	Win
scope of <firewall open port>	<firewall scope> Plural: scopes	Returns the Scope property of the firewall open port.	Win

firewall service

The <firewall service> Inspectors provide access to the properties of a service that may be authorized to listen through the firewall. These properties correspond to the INetFwService interface in the Windows Firewall API. The Windows Firewall is supported on Windows XP SP2. For more information, search for 'Windows Firewall API' at the msdn site (http://msdn.microsoft.com/library/).

Creation Methods

Declaration	Description	Platforms (?)
service of <firewall profile>	Gets the collection containing the services for this profile. This Inspector can be iterated over all services.	Win

Properties

Declaration	Return type	Description	Platforms (?)
customized of <firewall service>	<boolean> Plural: customizeds	Returns a flag that indicates whether at least one of the ports associated with the service has been customized. Either TRUE or FALSE.	Win
enabled of <firewall service>	<boolean> Plural: enableds	Returns the enabled flag for the specified firewall service.	Win
globally open port of <firewall service>	<firewall open port> Plural: globally open ports	Returns the collection of globally open ports associated with the firewall service.	Win
ip version of <firewall service>	<ip version> Plural: ip versions	Returns the the IP version for the specified firewall service.	Win
name of <firewall service>	<string> Plural: names	Returns the friendly name of the firewall service.	Win
remote addresses of <firewall service>	<string> Plural: remote addresseses	Returns the contents of the RemoteAddresses property for the specified firewall service.	Win
scope of <firewall service>	<firewall scope> Plural: scopes	Retrieves the contents of the Scope property of the firewall service.	Win
type of <firewall service>	<firewall service type> Plural: types	Returns the type of the specified firewall service (file and print, upnp, remote desktop or none).	Win

firewall service type

The <firewall service type> Inspectors provide access to the firewall service type. These properties correspond to the INetFwService.Type interface in the Windows Firewall API. The Windows Firewall is supported on Windows XP SP2. For more information, search for 'Windows Firewall API' at the msdn site (http://msdn.microsoft.com/library/).

Creation Methods

Declaration	Description	Platforms (?)
file_and_print firewall service type	Returns the global service type for file and print sharing, corresponding to the Microsoft enumerated type: NET_FW_SERVICE_FILE_AND_PRINT.	Win
firewall service type <integer>	Returns the firewall service type specified by <integer>. Example: names of services of current profile of local policy of firewall - Returns the names of the services of the current profile of the firewall's local policy, such as File and Printer Sharing, UPnP Framework & Remote Desktop.	Win
none firewall service type	Returns the no firewall service type, corresponding to the Microsoft enumerated type: NET_FW_SERVICE_NONE.	Win
remote desktop firewall service type	Returns the remote desktop firewall service type, corresponding to the Microsoft enumerated type: NET_FW_SERVICE_REMOTE_DESKTOP.	Win
upnp firewall service type	Returns the UPnP (Universal Plug and Play) firewall service type, corresponding to the Microsoft enumerated type: NET_FW_SERVICE_UPNP.Note: UPnP is not the same as PnP. UPnP is used for network connectivity via TCP/IP to various devices (scanners, printers, etcetera.).	Win
type of <firewall service>	Returns the type of the specified firewall service (file and print, upnp, remote desktop or none).	Win

Operators

Declaration	Return Type	Description	Platforms (?)
<firewall service type> = <firewall service type>	<boolean>	Compares two firewall service types for equality only.	Win

Properties

Declaration

Return type

Description

Platforms (?)

firewall icmp settings

The <firewall icmp settings> Inspectors provide access to the settings controlling Internet Control Message Protocol (ICMP) packets. These properties correspond to the INetFwIcmpSettings interface in the Windows Firewall API. The Windows Firewall is supported on Windows XP SP2. For more information, search for 'Windows Firewall API' at the msdn site (http://msdn.microsoft.com/library/).

Creation Methods

Declaration	Description	Platforms (?)
icmp settings of <firewall profile>	Gets the object governing settings for ICMP packets.	Win

Properties

Declaration	Return type	Description	Platforms (?)
allow inbound echo request of <firewall icmp settings>	<boolean> Plural: allow inbound echo requests	Returns the value of the AllowInboundEchoRequest property. Type common to IPv4 and IPv6.	Win
allow inbound mask request of <firewall icmp settings>	<boolean> Plural: allow inbound mask requests	Returns the value of the AllowInboundMaskRequest property. Type common to IPv4 only.	Win
allow inbound router request of <firewall icmp settings>	<boolean> Plural: allow inbound router requests	Returns the value of the AllowInboundRouterRequest property. Type common to IPv4 only.	Win
allow inbound timestamp request of <firewall icmp settings>	<boolean> Plural: allow inbound timestamp requests	Returns the value of the AllowInboundTimestampRequest property. Type common to IPv4 only.	Win
allow outbound destination unreachable of <firewall icmp settings>	<boolean> Plural: allow outbound destination unreachables	Returns the value of the AllowOutboundDestinationUnreachable property. Type common to IPv4 and IPv6.	Win
allow outbound packet too big of <firewall icmp settings>	<boolean> Plural: allow outbound packet too bigs	Returns the value of the AllowOutboundPacketTooBig property. Type common to IPv6 only.	Win
allow outbound parameter problem of <firewall icmp settings>	<boolean> Plural: allow outbound parameter problems	Returns the value of the AllowOutboundParameterProblem property. Type common to IPv4 and IPv6.	Win
allow outbound source quench of <firewall icmp settings>	<boolean> Plural: allow outbound source quenches	Returns the value of the AllowOutboundSourceQuench property. Type common to IPv4 only.	Win
allow outbound time exceeded of <firewall icmp settings>	<boolean> Plural: allow outbound time exceededs	Returns the value of the AllowOutboundTimeExceeded property. Type common to IPv4 and IPv6.	Win
allow redirect of <firewall icmp settings>	<boolean> Plural: allow redirects	Accesses the AllowRedirect property. Type common to IPv4 and IPv6.	Win

firewall action

The firewall action Inspectors provide wrappers around the Windows Vista Firewall API. These are Vista-only Inspectors.

Creation Methods

Declaration	Description	Platforms (?)
allow firewall action	Returns a value corresponding to the NET_FW_ACTION enumerated type, which specifies the action for a rule or default setting. This is a Vista Inspector. For more information, see the MSDN Library entry for NET_FW_ACTION.	Win
block firewall action	Returns a value corresponding to the NET_FW_ACTION enumerated type, which specifies the action for a rule or default setting. This is a Vista Inspector. For more information, see the MSDN Library entry for NET_FW_ACTION.	Win
firewall action <integer>	Returns the Nth enumerated type from the Firewall Action interface. This provides an alternative way to access the firewall action variables and requires Vista. For more information, see the MSDN Library entry for NET_FW_ACTION.	Win
action of <firewall rule>	Retrieves the Action property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win

Operators

Declaration	Return Type	Description	Platforms (?)
<firewall action> = <firewall action>	<boolean>	Compares two enumerated types corresponding to the firewall action. This is a Vista Inspector. For more information see the MSDN Library reference to NET_FW_ACTION.	Win

Properties

Declaration

Return type

Description

Platforms (?)

firewall local policy modify state

The <firewall local policy modify state> Inspectors provide a wrapper for the Windows Firewall Policy Modification State. They are Vista-only. On a non-Vista machine, they return no results. For more information see the MSDN Library reference to NET_FW_MODIFY_STATE at http://msdn.microsoft.com/library/.

Creation Methods

Declaration	Description	Platforms (?)
firewall local policy modify state <integer>	Returns a value corresponding to the NET_FW_MODIFY_STATE enumerated type, which specifies the effect of modifications to the current policy. The <integer> specifies the zero-based enumeration, and provides an alternative access method. For more information, see the MSDN Library entry for NET_FW_MODIFY_STATE.	Win
gp override firewall local policy modify state	Returns a value corresponding to the NET_FW_MODIFY_STATE enumerated type, which specifies the effect of modifications to the current policy. For more information, see the MSDN Library entry for NET_FW_MODIFY_STATE.	Win
inbound blocked firewall local policy modify state	Returns a value corresponding to the NET_FW_MODIFY_STATE enumerated type, which specifies the effect of modifications to the current policy. For more information, see the MSDN Library entry for NET_FW_MODIFY_STATE.	Win
ok firewall local policy modify state	Returns a value corresponding to the NET_FW_MODIFY_STATE enumerated type, which specifies the effect of modifications to the current policy. For more information, see the MSDN Library entry for NET_FW_MODIFY_STATE.	Win
local policy modify state of <firewall>	Determines if adding or setting a rule or group of rules will take effect in the specified firewall profile. For more information, see the MSDN Library entry for INetFwPolicy2.	Win

Operators

Declaration	Return Type	Description	Platforms (?)
<firewall local policy modify state> = <firewall local policy modify state>	<boolean>	Compares two enumerated types corresponding to the firewall policy modification state. This is a Vista Inspector. For more information see the MSDN Library reference to NET_FW_MODIFY_STATE.	Win

Properties

Declaration

Return type

Description

Platforms (?)

firewall rule

The <firewall rule> Inspectors provide a wrapper for the Windows Firewall Rule. They are Vista-only. On a non-Vista machine, they return no results. For more information, see the MSDN library for INetFwRule at http://msdn.microsoft.com/library/.

Creation Methods

Declaration	Description	Platforms (?)
rule of <firewall>	Retrieves the collection of rules for the specified firewall. For more information, see the MSDN Library article on INetFwPolicy2.	Win
rule of <firewall service restriction>	Retrieves the collection of Windows Service Hardening network rules for the specified firewall service restriction. For more information, see the MSDN Library section on INetFwServiceRestriction.	Win

Properties

Declaration	Return type	Description	Platforms (?)
action of <firewall rule>	<firewall action> Plural: actions	Retrieves the Action property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
application name of <firewall rule>	<string> Plural: application names	Retrieves the application name property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
currently active of <firewall rule>	<boolean> Plural: currently actives	Currently active is true if and only if the specified firewall rule is enabled (the Enabled property is true) AND the currently active profile type (as defined by the CurrentProfileTypes property of INetFwPolicy2) is one of the profiles for which the rule applies (as defined by the Profiles property). For more information see the MSDN Library articles for INetFwRule, including the CurrentProfileTypes and Profiles properties.	Win
description of <firewall rule>	<string> Plural: descriptions	Retrieves the Description property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
edge traversal allowed of <firewall rule>	<boolean> Plural: edge traversal alloweds	Retrieves the EdgeTraversal property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
enabled of <firewall rule>	<boolean> Plural: enableds	Retrieves the Enabled property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
grouping of <firewall rule>	<string> Plural: groupings	Retrieves the Grouping property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
icmp types_and_codes string of <firewall rule>	<string> Plural: icmp types_and_codes strings	Retrieves the IcmpTypesAndCodes property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
inbound of <firewall rule>	<boolean> Plural: inbounds	Retrieves the inbound direction property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule and IDispatch.	Win
interface of <firewall rule>	<string> Plural: interfaces	Retrieves the Interfaces property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
interface types string of <firewall rule>	<string> Plural: interface types strings	Retrieves the Interface types property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
local addresses string of <firewall rule>	<string> Plural: local addresses strings	Retrieves the Interfaces property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
local ports string of <firewall rule>	<string> Plural: local ports strings	Retrieves the LocalPorts property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
name of <firewall rule>	<string> Plural: names	Retrieves the Name property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
outbound of <firewall rule>	<boolean> Plural: outbounds	Retrieves the outbound direction property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule and IDispatch.	Win
profile <firewall profile type> of <firewall rule>	<boolean> Plural: profiles	Retrieves the given profile property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
protocol of <firewall rule>	<internet protocol> Plural: protocols	Retrieves the Protocol property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
remote addresses string of <firewall rule>	<string> Plural: remote addresses strings	Retrieves the RemoteAddresses property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
remote ports string of <firewall rule>	<string> Plural: remote ports strings	Retrieves the RemotePorts property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win
service name of <firewall rule>	<string> Plural: service names	Retrieves the ServiceName property for the specified firewall rule. The firewall rule Inspectors are wrappers around the Windows Vista Firewall API. For more information, see the MSDN library for INetFwRule.	Win

firewall service restriction

The <firewall service restriction> Inspectors provide a wrapper for the Windows Firewall Service Restriction. They are Vista-only. On a non-Vista machine, they return no results. For more information see the MSDN Library reference to INetFwServiceRestriction at http://msdn.microsoft.com/library/.

Creation Methods

Declaration	Description	Platforms (?)
service restriction of <firewall>	Retrieves the access interface to manipulate the Windows Service Hardening store. On Windows operating systems earlier than Vista, this Inspector always returns no-such-object. For more information, see the MSDN Library entry for INetFwPolicy2.	Win

Properties

Declaration	Return type	Description	Platforms (?)
rule of <firewall service restriction>	<firewall rule> Plural: rules	Retrieves the collection of Windows Service Hardening network rules for the specified firewall service restriction. For more information, see the MSDN Library section on INetFwServiceRestriction.	Win
service restricted <( string, string )> of <firewall service restriction>	<boolean> Plural: service restricteds	Returns the service restriction state of a given service. There are two strings passed to define the restriction: the service name and the application name. For more information, see the MSDN Library section on INetFwServiceRestriction.	Win

internet connection firewall

The <internet connection firewall> Inspectors provide access to the settings of the Internet Connection Firewall introduced in Windows XP. The Internet Connection Firewall helps to protect a computer that is directly connected to the Internet, or a home network, from network attacks.

Creation Methods

Declaration	Description	Platforms (?)
internet connection firewall of <network adapter>	Creates a Windows XP firewall object.	Win
firewall of <connection>	Returns the internet connection firewall object corresponding to the specified connection.	Win

Properties

Declaration	Return type	Description	Platforms (?)
enabled of <internet connection firewall>	<boolean> Plural: enableds	Returns TRUE if the local computer has the Windows XP built-in firewall enabled.	Win
port mapping of <internet connection firewall>	<port mapping> Plural: port mappings	Creates a port mapping object for the built-in firewall.	Win

port mapping

Refers to a port mapping object for the built-in firewall.

Creation Methods

Declaration	Description	Platforms (?)
port mapping of <internet connection firewall>	Creates a port mapping object for the built-in firewall.	Win

Properties

Declaration	Return type	Description	Platforms (?)
enabled of <port mapping>	<boolean> Plural: enableds	A boolean indicating whether or not the port mapping is enabled.	Win
external port of <port mapping>	<integer> Plural: external ports	Returns the external port number of the specified ICF port mapping.	Win
internal port of <port mapping>	<integer> Plural: internal ports	Returns the internal port number of the specified ICF port mapping.	Win
name of <port mapping>	<string> Plural: names	Returns the name of the specified port mapping.	Win
options of <port mapping>	<integer> Plural: optionss	See port mapping at MSDN.	Win
protocol of <port mapping>	<string> Plural: protocols	Returns a string like "tcp" or "udp", corresponding to the protocol of the specified port mapping.	Win
target ip address of <port mapping>	<ipv4 address> Plural: target ip addresses	Returns the target IPv4 address of the specified port mapping.	Win
target ipv4or6 address of <port mapping>	<ipv4or6 address> Plural: target ipv4or6 addresses	Returns the target IP address (ipv4or6) of the specified port mapping.	Win:8.0
target name of <port mapping>	<string> Plural: target names	Returns the target name of the specified port mapping.	Win

media type

The <media type> objects allow you to inspect the media type of your Internet Connection Firewall type connection, as returned in the NETCON_PROPERTIES structure.

Creation Methods

Declaration	Description	Platforms (?)
media type <integer>	Returns the media type based on its integer value. This Inspector is included to take advantage of new (or undocumented) additions to the media types.	Win
media type bridge	Returns the value NCM_BRIDGE: Bridged connection.	Win
media type direct	Returns the value NCM_DIRECT: Direct serial connection through a serial port.	Win
media type isdn	Returns the value NCM_ISDN: Connection is through an integrated services digital network (ISDN) line.	Win
media type lan	Returns the value NCM_LAN: Connection is to a local area network (LAN).	Win
media type phone	Returns the value NCM_PHONE: Dial-up connection over a conventional phone line.	Win
media type pppoe	Returns the value NCM_PPPOE: Point-to-Point protocol (PPP) over Ethernet.	Win
media type shared access host lan	Returns the value NCM_SHAREDACCESSHOST_LAN: Shared connection to a LAN.	Win
media type shared access host ras	Returns the value NCM_SHAREDACCESSHOST_RAS: Shared connection to a remote or wide area network (WAN).	Win
media type tunnel	Returns the value NCM_TUNNEL: Virtual private network (VPN) connection.	Win
media type of <connection>	Returns the media type of for the specified connection.	Win

Operators

Declaration	Return Type	Description	Platforms (?)
<media type> = <media type>	<boolean>	Compares two media types.	Win

Properties

Declaration

Return type

Description

Platforms (?)

Terminology

Platform

Contents