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 lauschende Sockets 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 Variable vom Typ ULONG, 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

Um den Status dieser Socketoption abzurufen, 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 Variable vom Typ ULONG, die den Wert des Zustands der Socketoption empfängt: 0: Senden von Keep-Alive-Paketen ist deaktiviert 1: Senden von Keep-Alive-Paketen ist aktiviert
OutputSizeReturned	NULL

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

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

Wenn diese Socketoption für einen Abhörsocket aktiviert ist, ist diese Socketoption für alle eingehenden Verbindungen, die für diesen Socket akzeptiert werden, standardmäßig aktiviert. Eine WSK-Anwendung kann die WskControlSocket-Funktion für einen akzeptierten Socket aufrufen, um den Zustand dieser Socketoption zu überschreiben, die vom lauschenden Socket 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".

Requirements (Anforderungen)

Version	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Header	Ws2def.h (einschließen von Wsk.h)