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

Article
03/04/2024

[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 EnableSharing permet le partage sur cette connexion.

Syntaxe

HRESULT EnableSharing(
  [in] SHARINGCONNECTIONTYPE Type
);

Paramètres

[in] Type

Spécifie si cette connexion est partagée publiquement ou en privé.

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é 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 d’activer le partage de connexion Internet sur la connexion réseau %connectionname%. Cela permettra à d’autres ordinateurs de votre réseau de se connecter à Internet via une connexion publique partagée. Voulez-vous que %programname% active le partage de connexion Internet sur cette connexion ?

Si l’application appelante spécifie que cette connexion est partagée publiquement, toute connexion précédemment partagée publiquement est automatiquement désactivée.

Le pare-feu de connexion Internet est automatiquement activé pour une connexion partagée publiquement. Les connexions partagées privées conservent leurs paramètres existants.

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