Partager via

INetSharingConfiguration ::D isableSharing, méthode (netcon.h)

  • Article

[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 DisableSharing désactive le partage sur cette connexion. Il désactive également tous les mappages sur cette connexion. Il ne désactive pas la configuration du pont ou du pare-feu de connexion Internet.

Syntaxe

HRESULT DisableSharing();

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
E_ABORT
 L'opération a été abandonné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
 Aucune méthode spécifiée n’est 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

L’appel de cette méthode déclenche la notification suivante :

%programname% tente de désactiver le partage de connexion Internet (ICS). Le nombre d’utilisateurs ou d’ordinateurs qui partagent actuellement la connexion Internet est le suivant : %nombre %. Voulez-vous autoriser %programname% à désactiver ICS ?

Cette méthode retourne correctement lorsqu’elle est appelée sur une connexion qui n’est pas activée pour le partage. Dans ce cas, la méthode désactive toujours tous les mappages sur la connexion.

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

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 ::EnableSharing

INetSharingConfiguration ::get_SharingEnabled

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