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

Article
03/13/2024

La méthode ServiceRestricted indique si les règles de restriction de service sont activées pour limiter le trafic aux ressources spécifiées par les règles de pare-feu.

Syntaxe

HRESULT ServiceRestricted(
  [in]  BSTR         serviceName,
  [in]  BSTR         appName,
  [out] VARIANT_BOOL *serviceRestricted
);

Paramètres

[in] serviceName

Nom du service interrogé concernant l’état de restriction du service.

[in] appName

Nom de l’application interrogée concernant l’état de restriction du service.

[out] serviceRestricted

Indique si des règles de restriction de service sont en place pour restreindre le service spécifié. Si la valeur est true (VARIANT_TRUE), le service est restreint. Sinon, le service n’est pas limité aux ressources spécifiées par les règles de pare-feu.

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.
E_OUTOFMEMORY	La méthode n’a pas pu allouer la mémoire requise.
E_POINTER	La méthode a échoué en raison d’un pointeur 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.
E_OUTOFMEMORY	La méthode n’a pas pu allouer la mémoire requise.
E_POINTER	La méthode a échoué en raison d’un pointeur non valide.

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