Fonction UnnableRouter (iphlpapi.h)
La fonction UnnableRouter décrémente le nombre de références qui suit le nombre de demandes pour activer le transfert IPv4. Lorsque ce nombre de références atteint zéro, UnnableRouter désactive le transfert IPv4 sur l’ordinateur local.
Syntaxe
IPHLPAPI_DLL_LINKAGE DWORD UnenableRouter(
OVERLAPPED *pOverlapped,
[out, optional] LPDWORD lpdwEnableCount
);
Paramètres
pOverlapped
Pointeur vers une structure OVERLAPPED. Cette structure doit être identique à celle utilisée dans l’appel à la fonction EnableRouter .
[out, optional] lpdwEnableCount
Pointeur facultatif vers une variable DWORD . Cette variable reçoit le nombre de références restantes.
Valeur retournée
Si la fonction réussit, la valeur de retour est NO_ERROR.
Si la fonction échoue, utilisez FormatMessage pour obtenir la chaîne de message correspondant à l’erreur retournée.
Remarques
La fonction UnnableRouter est spécifique au transfert IPv4. Chaque appel qu’un processus effectue à UnnableRouter doit correspondre à un appel précédent à EnableRouter par le même processus. Le système retourne une erreur sur les appels superflus à UnenableRouter. Par conséquent, un processus donné n’est pas en mesure de décrémenter le nombre de références qui suit le nombre de demandes permettant d’activer le transfert IPv4 pour un autre processus. En outre, si le transfert IPv4 a été activé par un processus donné, il ne peut pas être désactivé par un autre processus.
Il n’est pas possible de déterminer avec précision le nombre de références qui effectue le suivi du nombre de demandes d’activation du transfert IPv4, car d’autres demandes EnableRouter peuvent être en suspens. Ainsi, la valeur retournée pour le paramètre lpdwEnableCount est toujours un grand nombre égal à ULONG_MAX/2.
Si le processus qui appelle EnableRouter se termine sans appeler UnenableRouter, le système décrémente le nombre de références qui effectue le suivi des demandes pour activer le transfert IPv4 comme si le processus avait appelé UnnableRouter.
Après avoir appelé UnnableRouter, utilisez l’appel CloseHandle pour fermer le handle à l’objet d’événement dans la structure CHEVAUCHEMENT .
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 |
Voir aussi
Informations de référence sur la fonction d’assistance IP