Méthode INetFwService ::get_RemoteAddresses (netfw.h)
[L’API pare-feu Windows peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Pour Windows Vista et versions ultérieures, l’utilisation du Pare-feu Windows avec l’API de sécurité avancée est recommandée.]
Spécifie un ensemble d’adresses distantes à partir desquelles les ports de service peuvent écouter le trafic.
Cette propriété est en lecture/écriture.
Syntaxe
HRESULT get_RemoteAddresses(
BSTR *remoteAddrs
);
Paramètres
remoteAddrs
Valeur de retour
None
Remarques
Si le service a été personnalisé, get retourne l’union des adresses distantes pour tous les ports de service.
Le paramètre remoteAddrs se compose d’un ou plusieurs jetons délimités par des virgules spécifiant les adresses distantes à partir desquelles l’application peut écouter le trafic. La valeur par défaut est « * ».
Jetons valides :
- « * » : toute adresse distante ; s’il est présent, il doit s’agir du seul jeton.
- « LocalSubnet » : ne respecte pas la casse ; spécifier plusieurs fois n’a aucun effet.
- sous-réseau : peut être spécifié à l’aide du masque de sous-réseau ou de la notation de préfixe de réseau. Si ni un masque de sous-réseau ni un préfixe réseau ne sont spécifiés, le masque de sous-réseau est par défaut 255.255.255.255. Exemples de sous-réseaux valides : 10.0.0.2/255.0.0.0 10.0.0.2/8 10.0.0.2
- Windows Vista : adresse IPv6 valide.
- Windows Vista : plage d’adresses IPv4 au format « adresse de début - adresse de fin ».
- Windows Vista : plage d’adresses IPv6 au format « adresse de début - adresse de fin ».
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista, Windows XP avec SP2 [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2003 avec SP1 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | netfw.h |
DLL | FirewallAPI.dll ; Hnetcfg.dll sur Windows XP avec SP2 |