Partager via

Méthode INetFwPolicy ::GetProfileByType (netfw.h)

  • Article

[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.]

Récupère le profil du type demandé.

Syntaxe

HRESULT GetProfileByType(
  [in]       NET_FW_PROFILE_TYPE profileType,
  [out, ref] INetFwProfile       **profile
);

Paramètres

[in] profileType

Type de profil de NET_FW_PROFILE_TYPE.

[out, ref] profile

Profil récupéré de type INetFwProfile.

Profil récupéré de type INetFwProfile.

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_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, 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

INetFwPolicy

INetFwProfile

NET_FW_PROFILE_TYPE