SetTcpEntry-Funktion (iphlpapi.h)

Die SetTcpEntry-Funktion legt den Status einer TCP-Verbindung fest.

Syntax

IPHLPAPI_DLL_LINKAGE DWORD SetTcpEntry(
  [in] PMIB_TCPROW pTcpRow
);

Parameter

[in] pTcpRow

Ein Zeiger auf eine MIB_TCPROW-Struktur . Diese Struktur gibt Informationen an, um die zu ändernde TCP-Verbindung zu identifizieren. Außerdem wird der neue Zustand für die TCP-Verbindung angegeben. Der Aufrufer muss Werte für alle Member in dieser Struktur angeben.

Rückgabewert

Die Funktion gibt NO_ERROR (null) zurück, wenn die Funktion erfolgreich ist.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode/-wert	BESCHREIBUNG
ERROR_ACCESS_DENIED	Zugriff verweigert.“ Dieser Fehler wird unter Windows Vista und Windows Server 2008 unter folgenden Bedingungen zurückgegeben: Dem Benutzer fehlen die erforderlichen Administratorrechte auf dem lokalen Computer, oder die Anwendung wird nicht in einer erweiterten Shell als integrierter Administrator (RunAs-Administrator) ausgeführt.
ERROR_INVALID_PARAMETER	Ein Eingabeparameter ist ungültig, es wurde keine Aktion ausgeführt. Dieser Fehler wird zurückgegeben, wenn der pTcpRow-ParameterNULL ist oder der Row-Member in der MIB_TCPROW-Struktur , auf die der pTcpRow-Parameter verweist, nicht auf MIB_TCP_STATE_DELETE_TCB festgelegt ist.
ERROR_NOT_SUPPORTED	Der IPv4-Transport ist auf dem lokalen Computer nicht konfiguriert.
317	Die Funktion kann den TCP-Eintrag nicht festlegen, da die Anwendung nicht mit erhöhten Rechten ausgeführt wird.
Andere	Verwenden Sie FormatMessage , um die Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Derzeit ist der einzige Zustand, auf den eine TCP-Verbindung festgelegt werden kann, MIB_TCP_STATE_DELETE_TCB.

Unter Windows Vista und höher kann die SetTcpEntry-Funktion nur von einem Benutzer aufgerufen werden, der als Mitglied der Gruppe Administratoren angemeldet ist. Wenn SetTcpEntry von einem Benutzer aufgerufen wird, der kein Mitglied der Gruppe Administratoren ist, schlägt der Funktionsaufruf fehl, und ERROR_ACCESS_DENIED wird zurückgegeben.

Die SetTcpEntry-Funktion kann auch aufgrund der Benutzerkontensteuerung (User Account Control, UAC) unter Windows Vista und höher fehlschlagen. Wenn eine Anwendung, die diese Funktion enthält, von einem Benutzer ausgeführt wird, der als Mitglied der Gruppe Administratoren angemeldet ist, die nicht der integrierten Administratorgruppe angehört, schlägt dieser Aufruf fehl, es sei denn, die Anwendung wurde in der Manifestdatei mit einem requestedExecutionLevel gekennzeichnet, der auf requireAdministrator festgelegt ist. Wenn der Anwendung diese Manifestdatei fehlt, muss ein Benutzer, der sich als Mitglied der Gruppe Administratoren angemeldet hat, als der integrierte Administrator, die Anwendung dann in einer erweiterten Shell als integrierter Administrator (RunAs-Administrator) ausführen, damit diese Funktion erfolgreich ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	iphlpapi.h
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll

Weitere Informationen

Ip-Hilfsfunktionsreferenz

Startseite des IP-Hilfsprogrammes

MIB_TCPROW