Specifies the list of remote addresses for this rule.
This property is read/write.
Syntax (put)
HRESULT put_RemoteAddresses(
[in] BSTR remoteAddrs
);
Parameters
- remoteAddrs [in]
-
Sets the list of remote addresses for this rule.
Syntax (get)
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 code | Description |
- 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
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 client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Header | Netfw.h |
| DLL | FirewallAPI.dll |
See Also
- INetFwRule
Send comments about this topic to Microsoft
Build date: 1/14/2010