Partager via


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 ».
Pour une plage d’adresses prédéfinie, utilisez la propriété Scope .

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

Voir aussi

INetFwService