Funzione EnableRouter (iphlpapi.h)

Articolo
08/24/2023

La funzione EnableRouter attiva l'inoltro IPv4 nel computer locale. EnableRouter incrementa anche un numero di riferimenti che tiene traccia del numero di richieste per abilitare l'inoltro IPv4.

Sintassi

IPHLPAPI_DLL_LINKAGE DWORD EnableRouter(
  HANDLE     *pHandle,
  OVERLAPPED *pOverlapped
);

Parametri

pHandle

Puntatore a un handle. Questo parametro è attualmente inutilizzato.

pOverlapped

Puntatore a una struttura OVERLAPPED . Ad eccezione del membro hEvent , tutti i membri di questa struttura devono essere impostati su zero. Il membro hEvent deve contenere un handle per un oggetto evento valido. Usare la funzione CreateEvent per creare questo oggetto evento.

Valore restituito

Se la funzione EnableRouter ha esito positivo, il valore restituito è ERROR_IO_PENDING.

Se la funzione ha esito negativo, usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Uno dei parametri non è valido. Questo errore viene restituito se il parametro pOverlapped è NULL.
Altri	Usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Commenti

La funzione EnableRouter è specifica dell'inoltro IPv4. Se il processo che chiama EnableRouter termina senza chiamare UnenableRouter, il conteggio dei riferimenti rileva il numero di richieste per abilitare l'inoltro IPv4 come se il processo avesse chiamato UnenableRouter.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	iphlpapi.h
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll