Méthode INetFwAuthorizedApplications ::Add (netfw.h)
[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.]
La méthode Add ajoute une nouvelle application à la collection.
Syntaxe
HRESULT Add(
[in] INetFwAuthorizedApplication *app
);
Paramètres
[in] app
| C++ | Application à ajouter à la collection via un objet INetFWAuthorizedApplication . |
| VB | Application à ajouter à la collection via un objet INetFWAuthorizedApplication . |
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 |
|---|---|
|
L’opération a été abandonnée en raison de problèmes d’autorisations. |
|
La méthode a échoué, car un paramètre n’était pas valide. |
|
La méthode n’a pas pu allouer la mémoire requise. |
|
La méthode a échoué, car l’objet se trouve déjà dans la collection. |
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 |
|---|---|
|
L’opération a été abandonnée en raison de problèmes d’autorisations. |
|
La méthode a échoué, car un paramètre n’était pas valide. |
|
La méthode n’a pas pu allouer la mémoire requise. |
|
La méthode a échoué, car l’objet se trouve déjà dans la collection. |
Remarques
Si une application avec le même chemin existe déjà, les paramètres existants sont remplacés.
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 |