INetFwRule::RemoteAddresses Property

Specifies the list of remote addresses for this rule.

This property is read/write.


Syntax (put)

C++
HRESULT put_RemoteAddresses(
  [in]   BSTR remoteAddrs
);

Parameters

remoteAddrs [in]

Sets the list of remote addresses for this rule.

Syntax (get)

C++
HRESULT get_RemoteAddresses(
  [out]  BSTR *remoteAddrs
);

Parameters

remoteAddrs [out]

Gets the list of remote addresses for this rule.

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 codeDescription
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.

 


Syntax

VBScript
Property RemoteAddresses As STRING

Property Value

The list of remote addresses.

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 clientWindows Vista
Minimum supported serverWindows Server 2008
HeaderNetfw.h
DLLFirewallAPI.dll

See Also

INetFwRule

 

 

Send comments about this topic to Microsoft

Build date: 1/14/2010

Tags :


Page view tracker