Funzione SetTcpEntry (iphlpapi.h)
La funzione SetTcpEntry imposta lo stato di una connessione TCP.
Sintassi
IPHLPAPI_DLL_LINKAGE DWORD SetTcpEntry(
[in] PMIB_TCPROW pTcpRow
);
Parametri
[in] pTcpRow
Puntatore a una struttura MIB_TCPROW . Questa struttura specifica informazioni per identificare la connessione TCP da modificare. Specifica anche lo stato nuovo per la connessione TCP. Il chiamante deve specificare i valori per tutti i membri di questa struttura.
Valore restituito
La funzione restituisce NO_ERROR (zero) se la funzione ha esito positivo.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
| Codice/valore restituito | Descrizione |
|---|---|
|
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). |
|
Un parametro di input non è valido, non è stata eseguita alcuna azione. Questo errore viene restituito se il parametro pTcpRow è NULL o il membro Row nella struttura MIB_TCPROW a cui punta il parametro pTcpRow non è impostato su MIB_TCP_STATE_DELETE_TCB. |
|
Il trasporto IPv4 non è configurato nel computer locale. |
|
La funzione non è in grado di impostare la voce TCP perché l'applicazione esegue non con privilegi elevati. |
|
Usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito. |
Commenti
Attualmente, l'unico stato a cui è possibile impostare una connessione TCP è MIB_TCP_STATE_DELETE_TCB.
In Windows Vista e versioni successive, la funzione SetTcpEntry può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se SetTcpEntry viene chiamato da un utente che non è membro del gruppo Administrators, la chiamata alla funzione avrà esito negativo e viene restituita ERROR_ACCESS_DENIED.
La funzione SetTcpEntry può anche non riuscire a causa del controllo dell'account utente in Windows Vista e versioni successive. Se un'applicazione contenente 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 per richiedereAdministrator. Se l'applicazione manca di questo file manifesto, un utente ha eseguito l'accesso come membro del gruppo Administrators diverso dall'amministratore predefinito, deve quindi eseguire l'applicazione in una shell avanzata come amministratore predefinito (amministratore RunAs) per la riuscita di questa funzione.
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