Méthode INetFwServiceRestriction ::RestrictService (netfw.h)

Article
02/29/2024

La méthode RestrictService active ou désactive la restriction de service pour un service donné.

Syntaxe

HRESULT RestrictService(
  [in] BSTR         serviceName,
  [in] BSTR         appName,
  [in] VARIANT_BOOL restrictService,
  [in] VARIANT_BOOL serviceSidRestricted
);

Paramètres

[in] serviceName

Nom du service pour lequel la restriction de service est activée ou désactivée.

[in] appName

Nom de l’application pour laquelle la restriction de service est activée ou désactivée.

[in] restrictService

Indique si la restriction de service est activée ou désactivée. Si cette valeur est true (VARIANT_TRUE), le service est limité lors de l’envoi ou de la réception du trafic réseau. La collection de règles de renforcement du service Windows peut contenir des règles qui peuvent autoriser l’accès réseau entrant ou sortant spécifique à ce service selon des exigences spécifiques. Si la valeur est false (VARIANT_FALSE), le service n’est pas limité par le renforcement du service Windows.

[in] serviceSidRestricted

Indique le type de SID de service pour le service spécifié. Si cette valeur est true (VARIANT_TRUE), le SID de service est limité. Sinon, elle sera illimitée.

Valeur retournée

C++

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é abandonnée en raison de problèmes d’autorisations.
E_INVALIDARG	La méthode a échoué en raison d’un paramètre non 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é abandonnée en raison de problèmes d’autorisations.
E_INVALIDARG	La méthode a échoué en raison d’un paramètre non valide.

Remarques

Lors de l’ajout de règles, notez qu’il peut y avoir un petit décalage avant l’application de la règle nouvellement ajoutée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	netfw.h
DLL	FirewallAPI.dll

Voir aussi

INetFwServiceRestriction

Partager via