Funzione UnenableRouter (iphlpapi.h)

Articolo
03/13/2024

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