Export (0) Print
Expand All

INetFwRule::RemoteAddresses property

Specifies the list of remote addresses for this rule.

This property is read/write.

Syntax


HRESULT put_RemoteAddresses(
  [in]   BSTR remoteAddrs
);

HRESULT get_RemoteAddresses(
  [out]  BSTR *remoteAddrs
);

Property value

The list of remote 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 remoteAddrs parameter consists of one or more comma-delimited tokens specifying the remote addresses from which the application can listen for traffic. The default value is "*". Valid tokens include:

  • "*" indicates any remote address. If present, this must be the only token included.
  • "Defaultgateway"
  • "DHCP"
  • "DNS"
  • "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