Fonction CreateProxyArpEntry (iphlpapi.h)
La fonction CreateProxyArpEnry crée une entrée PARP (Proxy Address Resolution Protocol) sur l’ordinateur local pour l’adresse IPv4 spécifiée.
Syntaxe
IPHLPAPI_DLL_LINKAGE DWORD CreateProxyArpEntry(
[in] DWORD dwAddress,
[in] DWORD dwMask,
[in] DWORD dwIfIndex
);
Paramètres
[in] dwAddress
Adresse IPv4 pour laquelle cet ordinateur fait office de proxy.
[in] dwMask
Masque de sous-réseau pour l’adresse IPv4 spécifiée dans dwAddress.
[in] dwIfIndex
Index de l’interface sur laquelle proxyer ARP pour l’adresse IPv4 identifiée par dwAddress. En d’autres termes, lorsqu’une demande ARP pour dwAddress est reçue sur cette interface, l’ordinateur local répond avec l’adresse physique de cette interface. Si cette interface est d’un type qui ne prend pas en charge ARP, tel que PPP, l’appel échoue.
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 |
|---|---|
|
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). |
|
Un paramètre d’entrée n’est pas valide, aucune action n’a été effectuée. Cette erreur est retournée si le paramètre dwAddress est égal à zéro ou si une valeur n’est pas valide, si l’un des autres paramètres n’est pas valide. |
|
Le transport IPv4 n’est pas configuré sur l’ordinateur local. |
|
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 . Pour supprimer une entrée PARP existante, appelez deleteProxyArpEntry.
Sur Windows Vista et versions ultérieures, la fonction CreateProxyArpEnry ne peut être appelée que par un utilisateur connecté en tant que membre du groupe Administrateurs. Si CreateProxyArpEnry 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.
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 |
Voir aussi
Informations de référence sur la fonction d’assistance IP