Méthode INetFwAuthorizedApplications ::Remove (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 Remove supprime une application de la collection.
Syntaxe
HRESULT Remove(
[in] BSTR imageFileName
);
Paramètres
[in] imageFileName
Nom de l’application à supprimer.
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é en raison d’un paramètre non valide. |
|
La méthode n’a pas pu allouer la mémoire requise. |
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é en raison d’un paramètre non valide. |
|
La méthode n’a pas pu allouer la mémoire requise. |
Remarques
Le paramètre imageFileName doit être un chemin d’accès complet et peut contenir des variables d’environnement.
Si l’application n’existe pas dans la collection, la méthode Remove n’a aucun effet.
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 |