Freigeben über


SO_KEEPALIVE

Der Status der SO_KEEPALIVE Socketoption bestimmt, ob Keep-Alive-Pakete an einen verbindungsorientierten Socket gesendet werden. Diese Socketoption gilt nur für Überwachungssockets und verbindungsorientierte Sockets.

Um den Status dieser Socketoption festzulegen, ruft eine WSK-Anwendung die WskControlSocket--Funktion mit den folgenden Parametern auf.

Parameter Wert

RequestType-

WskSetOption-

ControlCode-

SO_KEEPALIVE

Level

SOL_SOCKET

InputSize-

sizeof(ULONG)

InputBuffer-

Ein Zeiger auf eine ULONG-Typvariable, die den Wert für den neuen Zustand der Socketoption enthält:

  • 0: Deaktivieren des Sendens von Keep-Alive-Paketen

  • 1: Aktivieren des Sendens von Keep-Alive-Paketen

OutputSize-

0

OutputBuffer-

NULL

OutputSizeReturned

NULL

Zum Abrufen des Zustands dieser Socketoption ruft eine WSK-Anwendung die WskControlSocket- Funktion mit den folgenden Parametern auf.

Parameter Wert

RequestType-

WskGetOption-

ControlCode-

SO_KEEPALIVE

Level

SOL_SOCKET

InputSize-

0

InputBuffer-

NULL

OutputSize-

sizeof(ULONG)

OutputBuffer-

Ein Zeiger auf eine ULONG-Typvariable, die den Wert des Zustands der Socketoption empfängt:

  • 0: Das Senden von Keep-Alive-Paketen ist deaktiviert.

  • 1: Das Senden von Keep-Alive-Paketen ist aktiviert.

OutputSizeReturned

NULL

Eine WSK-Anwendung muss beim Aufrufen der WskControlSocket--Funktion einen Zeiger auf ein IRP angeben, um den Status der SO_KEEPALIVE Socketoption festzulegen oder abzurufen.

Der Standardstatus dieser Socketoption besteht darin, dass das Senden von Keep-Alive-Paketen deaktiviert ist.

Wenn diese Socketoption in einem Überwachungssocket aktiviert ist, sind alle eingehenden Verbindungen, die in diesem Überwachungssocket akzeptiert werden, standardmäßig diese Socketoption aktiviert. Eine WSK-Anwendung kann die WskControlSocket--Funktion für einen akzeptierten Socket aufrufen, um den Zustand dieser Socketoption außer Kraft zu setzen, die vom Überwachungssocket geerbt wurde.

Keep-Alive-Pakete werden vom zugrunde liegenden Netzwerktransport gesendet. Nicht alle Netzwerktransporte unterstützen das Senden von Keep-Alive-Paketen.

Weitere Informationen zur Verwendung von Keep-Alive-Paketen finden Sie unter RFC 1122, Abschnitt 4.2.3.6, "TCP Keep-Alives".

Anforderungen

Version

Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.

Kopfzeile

Ws2def.h (enthalten Wsk.h)