Méthode INetFwServices ::Item (netfw.h)

Article
02/29/2024

[L’API pare-feu Windows est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Pour Windows Vista et versions ultérieures, l’utilisation du Pare-feu Windows avec l’API Advanced Security est recommandée.]

Retourne le service spécifié s’il se trouve dans la collection.

Syntaxe

HRESULT Item(
  [in]  NET_FW_SERVICE_TYPE svcType,
  [out] INetFwService       **service
);

Paramètres

[in] svcType

C++	Type de service à récupérer.
VB	Type de service à récupérer. Voir NET_FW_SERVICE_TYPE

[out] service

C++	Référence à l’objet INetFwService retourné.
VB	Référence à l’objet INetFwService retourné.

Valeur retournée

C++

Code de retour	Description
E_ACCESSDENIED	L’opération a été abandonnée en raison de problèmes d’autorisations.
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.
E_INVALIDARG	La méthode a échoué en raison d’un paramètre non valide.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	La méthode a échoué, car l’élément demandé n’existe pas.

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_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.
E_INVALIDARG	La méthode a échoué en raison d’un paramètre non valide.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	La méthode a échoué, car l’élément demandé n’existe pas.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	netfw.h
DLL	FirewallAPI.dll ; Hnetcfg.dll sur Windows XP avec SP2

Voir aussi

INetFwService

INetFwServices

NET_FW_SERVICE_TYPE

Partager via