Méthode INetSharingConfiguration ::D isableInternetFirewall (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 DisableInternetFirewall désactive le pare-feu de connexion Internet sur cette connexion.
Syntaxe
HRESULT DisableInternetFirewall();
Valeur de retour
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 |
|---|---|
|
L’opération a été arrêtée. |
|
Une erreur non spécifiée s'est produite. |
|
L’un des paramètres n’est pas valide. |
|
Une interface spécifiée n’est pas prise en charge. |
|
Aucune méthode spécifiée n’est implémentée. |
|
La méthode n’a pas pu allouer la mémoire requise. |
|
Un pointeur passé en tant que paramètre n’est pas valide. |
|
La méthode a échoué pour des raisons inconnues. |
Remarques
L’appel de cette méthode déclenche la notification suivante :
%programname% tente de désactiver votre pare-feu de connexion Internet. Cela rend votre ordinateur plus vulnérable aux menaces de sécurité Internet. Voulez-vous autoriser %programname% à désactiver le pare-feu de connexion Internet ?
Cette méthode retourne correctement même si le pare-feu de connexion Internet n’a pas été activé sur cette connexion.
Utilisez la méthode INetSharingManager ::get_INetSharingConfigurationForINetConnection pour obtenir une interface INetSharingConfiguration pour une connexion particulière.
Windows XP avec SP2 : L’appel de cette API désactive le pare-feu sur l’interface spécifiée, que le Pare-feu Windows soit activé ou non.
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 |