Funzione UnenableRouter (iphlpapi.h)
La funzione UnenableRouter decrementa il conteggio dei riferimenti che tiene traccia del numero di richieste per abilitare l'inoltro IPv4. Quando questo conteggio di riferimenti raggiunge zero, UnenableRouter disattiva l'inoltro IPv4 nel computer locale.
Sintassi
IPHLPAPI_DLL_LINKAGE DWORD UnenableRouter(
OVERLAPPED *pOverlapped,
[out, optional] LPDWORD lpdwEnableCount
);
Parametri
pOverlapped
Puntatore a una struttura OVERLAPPED . Questa struttura deve essere uguale a quella usata nella chiamata alla funzione EnableRouter .
[out, optional] lpdwEnableCount
Puntatore facoltativo a una variabile DWORD . Questa variabile riceve il numero di riferimenti rimanenti.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è NO_ERROR.
Se la funzione ha esito negativo, usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito.
Commenti
La funzione UnenableRouter è specifica per l'inoltro IPv4. Ogni chiamata eseguita da un processo a UnenableRouter deve corrispondere a una chiamata precedente a EnableRouter dallo stesso processo. Il sistema restituisce un errore nelle chiamate extranee a UnenableRouter. Di conseguenza, un determinato processo non è in grado di decretare il conteggio dei riferimenti che tiene traccia del numero di richieste per abilitare l'inoltro IPv4 per un altro processo. Inoltre, se l'inoltro IPv4 è stato abilitato da un determinato processo, non può essere disabilitato da un processo diverso.
Non è possibile determinare con precisione il conteggio dei riferimenti che tiene traccia del numero di richieste per l'abilitazione dell'inoltro IPv4 perché potrebbero essere presenti altre richieste EnableRouter in sospeso. Quindi il valore restituito per il parametro lpdwEnableCount è sempre un numero elevato uguale a ULONG_MAX/2.
Se il processo che chiama EnableRouter termina senza chiamare UnenableRouter, il conteggio dei riferimenti che tiene traccia delle richieste per abilitare l'inoltro IPv4 come se il processo avesse chiamato UnenableRouter.
Dopo aver chiamato UnenableRouter, usare la chiamata CloseHandle per chiudere l'handle all'oggetto evento nella struttura OVERLAPPED .
Requisiti
| Requisito | Valore |
|---|---|
| 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 |
Vedi anche
Informazioni di riferimento sulla funzione helper IP