SetTcpEntry-Funktion (iphlpapi.h)
Die SetTcpEntry-Funktion legt den Zustand 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 TCP-Verbindung zu identifizieren, die geändert werden soll. Außerdem wird der neue Zustand für die TCP-Verbindung angegeben. Der Aufrufer muss Werte für alle Elemente 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 |
|---|---|
|
Zugriff verweigert.“ Dieser Fehler wird unter mehreren Bedingungen auf Windows Vista und Windows Server 2008 zurückgegeben: Der Benutzer fehlt den erforderlichen Administratorrechten auf dem lokalen Computer oder die Anwendung wird nicht in einer erweiterten Shell als integrierter Administrator (RunAs-Administrator) ausgeführt. |
|
Ein Eingabeparameter ist ungültig, es wurde keine Aktion ausgeführt. Dieser Fehler wird zurückgegeben, wenn der pTcpRow-Parameter NULL oder das Element "Zeile" in der MIB_TCPROW Struktur ist, auf die der pTcpRow-Parameter verweist, nicht auf MIB_TCP_STATE_DELETE_TCB festgelegt ist. |
|
Der IPv4-Transport ist auf dem lokalen Computer nicht konfiguriert. |
|
Die Funktion kann den TCP-Eintrag nicht festlegen, da die Anwendung nicht mit erhöhten Rechten ausgeführt wird. |
|
Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen. |
Bemerkungen
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 zurückgegeben wird.
Die SetTcpEntry-Funktion kann auch aufgrund der Benutzerkontensteuerung (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 als der integrierte Administrator, schlägt dieser Aufruf fehl, es sei denn, die Anwendung wurde in der Manifestdatei mit einem angefordertenExecutionLevel-Satz markiert, um Administrator zu benötigen. Wenn die Anwendung diese Manifestdatei fehlt, muss ein Benutzer als Mitglied der Gruppe "Administratoren" außer dem integrierten Administrator die Anwendung in einer erweiterten Shell als der integrierte Administrator (RunAs-Administrator) ausführen, um erfolgreich zu sein.
Anforderungen
| 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 |