Export (0) Print
Expand All

INetFwRule::LocalAddresses property

Specifies the list of local addresses for this rule.

This property is read/write.

Syntax


HRESULT put_LocalAddresses(
  [in]   BSTR localAddrs
);

HRESULT get_LocalAddresses(
  [out]  BSTR *localAddrs
);

Property value

The list of local addresses.

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.

NameMeaning
E_ACCESSDENIED

The operation was aborted due to permissions issues.

E_INVALIDARG

The method failed due to an invalid parameter.

E_OUTOFMEMORY

The method was unable to allocate required memory.

E_POINTER

The method failed due to an invalid pointer.

Remarks

This property is optional.

Also see the restrictions on changing properties described in the Remarks section of the INetFwRule interface page.

The localAddrs parameter consists of one or more comma-delimited tokens specifying the local addresses from which the application can listen for traffic. "*" is the default value. Valid tokens include:

  • "*" indicates any local address. If present, this must be the only token included.
  • "Defaultgateway"
  • "DHCP"
  • "WINS"
  • "LocalSubnet" indicates any local address on the local subnet. This token is not case-sensitive.
  • A subnet can be specified using either the subnet mask or network prefix notation. If neither a subnet mask not a network prefix is specified, the subnet mask defaults to 255.255.255.255.
  • A valid IPv6 address.
  • An IPv4 address range in the format of "start address - end address" with no spaces included.
  • An IPv6 address range in the format of "start address - end address" with no spaces included.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Netfw.h

DLL

FirewallAPI.dll

See also

INetFwRule

 

 

Build date: 11/16/2013

Community Additions

ADD
Show:
© 2014 Microsoft