Méthode INetFwMgr ::IsIcmpTypeAllowed (netfw.h)

Article
02/01/2024

[L’API pare-feu Windows est disponible pour une utilisation 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 Advanced Security est recommandée.]

Détermine si le type ICMP spécifié est autorisé.

Syntaxe

HRESULT IsIcmpTypeAllowed(
  [in]  NET_FW_IP_VERSION ipVersion,
  [in]  BSTR              localAddress,
  [in]  BYTE              type,
  [out] VARIANT           *allowed,
  [out] VARIANT           *restricted
);

Paramètres

[in] ipVersion

Version IP du trafic. Cela ne peut pas être NET_FW_IP_VERSION_ANY.

[in] localAddress

Une adresse IPv4 décimale en pointillés ou une adresse hexadécimale IPv6 spécifiant l’adresse locale du trafic. En règle générale, il s’agit de l’adresse passée à lier. Si localAddress a la valeur NULL, la fonction détermine si le port est autorisé pour toutes les interfaces.

[in] type

Type ICMP. Pour obtenir la liste des types ICMP possibles, consultez ICMP Type Numbers.

[out] allowed

Indique par une valeur de VARIANT_TRUE ou VARIANT_FALSE si le port est autorisé pour au moins certaines interfaces locales et adresses distantes.

[out] restricted

Indique par une valeur de VARIANT_TRUE ou VARIANT_FALSE si certaines interfaces locales ou adresses distantes sont bloquées pour ce port. Par exemple, si le port est limité au sous-réseau local uniquement.

Valeur retournée

C++

Code de retour	Description
E_ACCESSDENIED	L’opération a été arrêtée en raison de problèmes d’autorisations.
E_INVALIDARG	La méthode a échoué, car un paramètre n’était pas valide.
E_OUTOFMEMORY	La méthode n’a pas pu allouer la mémoire requise.
E_POINTER	La méthode a échoué, car un pointeur n’était pas valide.

VB

Si la méthode réussit, la valeur de retour est S_OK.

Si la méthode échoue, la valeur de retour est l’un des codes d’erreur suivants.

Code de retour	Description
E_ACCESSDENIED	L’opération a été arrêtée en raison de problèmes d’autorisations.
E_INVALIDARG	La méthode a échoué, car un paramètre n’était pas valide.
E_OUTOFMEMORY	La méthode n’a pas pu allouer la mémoire requise.
E_POINTER	La méthode a échoué, car un pointeur n’était pas valide.

Remarques

La méthode INetFwPolicy2 ::IsRuleGroupEnabled est généralement recommandée à la place de cette méthode.

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

INetFwMgr

NET_FW_IP_VERSION

Partager via