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

Voir aussi

CloseHandle

EnableRouter

Informations de référence sur la fonction d’assistance IP

Page d’accueil de l’assistance IP

OVERLAPPED