Fonction EnableRouter (iphlpapi.h)
La fonction EnableRouter active le transfert IPv4 sur l’ordinateur local. EnableRouter incrémente également un nombre de références qui suit le nombre de requêtes pour activer le transfert IPv4.
Syntaxe
IPHLPAPI_DLL_LINKAGE DWORD EnableRouter(
HANDLE *pHandle,
OVERLAPPED *pOverlapped
);
Paramètres
pHandle
Pointeur vers un handle. Ce paramètre n’est actuellement pas utilisé.
pOverlapped
Pointeur vers une structure OVERLAPPED. À l’exception du membre hEvent , tous les membres de cette structure doivent être définis sur zéro. Le membre hEvent doit contenir un handle pour un objet d’événement valide. Utilisez la fonction CreateEvent pour créer cet objet d’événement.
Valeur retournée
Si la fonction EnableRouter réussit, la valeur de retour est ERROR_IO_PENDING.
Si la fonction échoue, utilisez FormatMessage pour obtenir la chaîne de message correspondant à l’erreur retournée.
| Code de retour | Description |
|---|---|
|
L’un des paramètres n’est pas valide. Cette erreur est retournée si le paramètre pOverlapped a la valeur NULL. |
|
Utilisez FormatMessage pour obtenir la chaîne de message pour l’erreur retournée. |
Notes
La fonction EnableRouter est spécifique au transfert IPv4. Si le processus qui appelle EnableRouter se termine sans appeler UnnableRouter, le système décrémente le nombre de références qui suit le nombre de demandes pour activer le transfert IPv4 comme si le processus avait appelé UnnableRouter.
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