SetIpNetEntry, fonction (iphlpapi.h)

Article
02/28/2024

La fonction SetIpNetEntry modifie une entrée ARP existante dans la table ARP sur l’ordinateur local.

Syntaxe

IPHLPAPI_DLL_LINKAGE DWORD SetIpNetEntry(
  [in] PMIB_IPNETROW pArpEntry
);

Paramètres

[in] pArpEntry

Pointeur vers une structure MIB_IPNETROW . Les informations contenues dans cette structure spécifient l’entrée à modifier et les nouvelles informations pour l’entrée. L’appelant doit spécifier des valeurs pour tous les membres de cette structure.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

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

Code de retour	Description
ERROR_ACCESS_DENIED	L’accès est refusé. Cette erreur est retournée sur Windows Vista et Windows Server 2008 dans plusieurs conditions, notamment : 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	Le paramètre pArpEntry est NULL, ou SetIpNetEntry ne peut pas lire à partir de la mémoire vers laquelle pArpEntry pointe, ou l’un des membres de la structure MIB_IPNETROW n’est pas valide.
ERROR_NOT_SUPPORTED	Le transport IPv4 n’est pas configuré sur l’ordinateur local.
Autres	Utilisez FormatMessage pour obtenir la chaîne de message de l’erreur retournée.

Remarques

Sur Windows Vista et versions ultérieures , la fonction SetIpNetEntry ne peut être appelée que par un utilisateur connecté en tant que membre du groupe Administrateurs. Si SetIpNetEntry est appelé par un utilisateur qui n’est pas membre du groupe Administrateurs, l’appel de fonction échoue et ERROR_ACCESS_DENIED est retourné.

La fonction SetIpNetEntry 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 requestedExecutionLevel défini sur requireAdministrator. Si l’application ne dispose pas de ce fichier manifeste, un utilisateur connecté en tant que membre du groupe Administrateurs autre que l’administrateur intégré doit ensuite exécuter l’application dans un interpréteur de commandes amélioré en tant qu’administrateur intégré (administrateur d’exécution) pour que cette fonction réussisse.

Note Sur Windows NT 4.0 et Windows 2000 et versions ultérieures, 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.

Configuration requise

Condition requise	Valeur
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