Funzione SetIpStatistics (iphlpapi.h)

Articolo
08/24/2023

La funzione SetIpStatistics attiva o disattiva l'inoltro IP e imposta il valore TTL (Time-to-Live) predefinito per il computer locale.

Sintassi

IPHLPAPI_DLL_LINKAGE DWORD SetIpStatistics(
  [in] PMIB_IPSTATS pIpStats
);

Parametri

[in] pIpStats

Puntatore a una struttura MIB_IPSTATS . Il chiamante deve impostare i membri dwForwarding e dwDefaultTTL di questa struttura sui nuovi valori. Per mantenere uno dei membri al valore corrente, usare MIB_USE_CURRENT_TTL o MIB_USE_CURRENT_FORWARDING.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Codice restituito	Descrizione
ERROR_ACCESS_DENIED	Accesso negato. Questo errore viene restituito in Windows Vista e Windows Server 2008 in diverse condizioni che includono quanto segue: l'utente non dispone dei privilegi amministrativi necessari nel computer locale o l'applicazione non è in esecuzione in una shell avanzata come amministratore predefinito (amministratore RunAs).
ERROR_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se viene passato un puntatore NULL nel parametro pIpStats . Questo errore viene restituito anche se il membro dwForwarding nella struttura MIB_IPSTATS a cui punta il parametro pIpStats contiene un valore diverso da MIB_IP_NOT_FORWARDING, MIB_IP_FORWARDING o MIB_USE_CURRENT_FORWARDING.
Altri	Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Commenti

Per impostare solo la durata (TTL) predefinita, il chiamante può usare anche la funzione SetIpTTL .

In Windows Vista e versioni successive la funzione SetIpStatistics può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se SetIpStatistics viene chiamato da un utente che non è membro del gruppo Administrators, la chiamata di funzione avrà esito negativo e ERROR_ACCESS_DENIED viene restituito.

La funzione SetIpStatistics può avere esito negativo anche a causa del controllo dell'account utente in Windows Vista e versioni successive. Se un'applicazione che contiene questa funzione viene eseguita da un utente connesso come membro del gruppo Administrators diverso dall'amministratore predefinito, questa chiamata avrà esito negativo a meno che l'applicazione non sia stata contrassegnata nel file manifesto con un set requestedExecutionLevel impostato su requireAdministrator. Se l'applicazione non dispone di questo file manifesto, un utente connesso come membro del gruppo Administrators diverso dall'amministratore predefinito deve quindi eseguire l'applicazione in una shell avanzata come amministratore predefinito (amministratore RunAs) affinché questa funzione abbia esito positivo.

Nota In Windows NT 4.0 e Windows 2000 e versioni successive questa funzione esegue un'operazione con privilegi. Affinché questa funzione venga eseguita correttamente, il chiamante deve essere connesso come membro del gruppo Administrators o del gruppo NetworkConfigurationOperators.

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