DeleteProxyArpEntry, fonction (iphlpapi.h)

Article
08/24/2023

La fonction DeleteProxyArpEntry supprime l’entrée PARP sur l’ordinateur local spécifié par les paramètres dwAddress et dwIfIndex .

Syntaxe

IPHLPAPI_DLL_LINKAGE DWORD DeleteProxyArpEntry(
  [in] DWORD dwAddress,
  [in] DWORD dwMask,
  [in] DWORD dwIfIndex
);

Paramètres

[in] dwAddress

Adresse IPv4 pour laquelle cet ordinateur agit en tant que proxy.

[in] dwMask

Masque de sous-réseau pour l’adresse IPv4 spécifiée dans le paramètre dwAddress .

[in] dwIfIndex

Index de l’interface sur laquelle cet ordinateur prend en charge le proxy ARP pour l’adresse IP spécifiée par le paramètre dwAddress .

Valeur retournée

La fonction retourne NO_ERROR (zéro) si la fonction réussit.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_ACCESS_DENIED	Accès refusé. Cette erreur est retournée sur Windows Vista et Windows Server 2008 dans plusieurs conditions qui incluent les suivantes : l’utilisateur n’a pas les privilèges d’administration requis sur l’ordinateur local ou l’application ne s’exécute pas dans un interpréteur de commandes amélioré en tant qu’administrateur intégré (administrateur runas).
ERROR_INVALID_PARAMETER	Un paramètre d’entrée n’est pas valide, aucune action n’a été effectuée.
ERROR_NOT_SUPPORTED	Le transport IPv4 n’est pas configuré sur l’ordinateur local.
Autres	Utilisez FormatMessage pour obtenir la chaîne de message pour l’erreur retournée.

Notes

Pour récupérer la table ARP, appelez la fonction GetIpNetTable .

Sur Windows Vista et versions ultérieures, la fonction DeleteProxyArpEntry ne peut être appelée que par un utilisateur connecté en tant que membre du groupe Administrateurs. Si DeleteProxyArpEntry est appelé par un utilisateur qui n’est pas membre du groupe Administrateurs, l’appel de fonction échoue et ERROR_ACCESS_DENIED est retourné. Cette fonction peut également échouer en raison du contrôle de compte d’utilisateur (UAC) sur Windows Vista et versions ultérieures. Si une application qui contient cette fonction est exécutée par un utilisateur connecté en tant que membre du groupe Administrateurs autre que l’administrateur intégré, cet appel échoue, sauf si l’application a été marquée dans le fichier manifeste avec un paramètre requestedExecutionLevel défini sur requireAdministrator. Si l’application sur Windows Vista et les versions ultérieures ne dispose pas de ce fichier manifeste, un utilisateur connecté en tant que membre du groupe Administrateurs autre que l’administrateur intégré doit alors exécuter l’application dans un interpréteur de commandes amélioré en tant qu’administrateur intégré (administrateur d’runas) pour que cette fonction réussisse.

Note Cette fonction exécute une opération privilégiée. Pour que cette fonction s’exécute correctement, l’appelant doit être connecté en tant que membre du groupe Administrateurs ou du groupe NetworkConfigurationOperators.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	iphlpapi.h
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll