INetFwRules ::Add, méthode (netfw.h)
La méthode Add ajoute une nouvelle règle à la collection.
Syntaxe
HRESULT Add(
[in] INetFwRule *rule
);
Paramètres
[in] rule
Règle à ajouter à la collection via un objet INetFwRule .
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 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 a échoué, car l’objet se trouve déjà dans la collection. |
Remarques
Si une règle avec le même identificateur de règle que celui soumis existe déjà, la règle existante est remplacée.
L’ajout d’une règle de pare-feu avec un LocalAppPackageId spécifié peut entraîner un comportement inattendu et n’est pas pris en charge.
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 |