Partager via


Méthode INetSharingConfiguration ::get_InternetFirewallEnabled (netcon.h)

[Le pare-feu de connexion Internet peut être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt l’API pare-feu Windows.]

La méthode get_InternetFirewallEnabled détermine si le pare-feu de connexion Internet est activé sur cette connexion.

Syntaxe

HRESULT get_InternetFirewallEnabled(
  [out] VARIANT_BOOL *pbEnabled
);

Paramètres

[out] pbEnabled

Pointeur vers une variable VARIANT_BOOL qui, en cas de retour réussi, spécifie si le pare-feu de connexion Internet est activé. Si le Pare-feu de connexion Internet est activé, cette valeur est TRUE. Sinon, il est FALSE.

Valeur retournée

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_ABORT
L’opération a été arrêtée.
E_FAIL
Une erreur non spécifiée s'est produite.
E_INVALIDARG
L’un des paramètres n’est pas valide.
E_NOINTERFACE
Une interface spécifiée n’est pas prise en charge.
E_NOTIMPL
Une méthode spécifiée n’est pas implémentée.
E_OUTOFMEMORY
La méthode n’a pas pu allouer la mémoire requise.
E_POINTER
Un pointeur passé en tant que paramètre n’est pas valide.
E_UNEXPECTED
La méthode a échoué pour des raisons inconnues.

Remarques

Utilisez la méthode INetSharingManager ::get_INetSharingConfigurationForINetConnection pour obtenir une interface INetSharingConfiguration pour une connexion particulière.

Windows XP avec SP2 : Le status de pare-feu résultant est déterminé par la combinaison de deux niveaux : tout d’abord case activée le mode de fonctionnement global, puis le mode sur l’interface concernée. Utilisez la procédure Vérification de l’état effectif du pare-feu pour déterminer l’état opérationnel global.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête netcon.h
DLL Hnetcfg.dll

Voir aussi

INetSharingConfiguration

INetSharingConfiguration ::D isableInternetFirewall

INetSharingConfiguration ::EnableInternetFirewall

Partage de connexion Internet et interfaces de pare-feu de connexion Internet

Informations de référence sur le partage de connexion Internet et le pare-feu de connexion Internet