SO_KEEPALIVE

De status van de SO_KEEPALIVE socketoptie bepaalt of keep-alive-pakketten worden verzonden op een verbindingsgeoriënteerde socket. Deze socketoptie is alleen van toepassing op luistersockets en verbindinggerichte sockets.

Als u de status van deze socketoptie wilt instellen, roept een WSK-toepassing de WskControlSocket- functie aan met de volgende parameters.

Parameter	Waarde
RequestType	WskSetOption
ControlCode-	SO_KEEPALIVE
niveau	SOL_SOCKET
InvoerGrootte	sizeof(ULONG)
Invoerbuffer	Een aanwijzer naar een ULONG-variabele die de waarde voor de nieuwe status van de socketoptie bevat: 0: Verzenden van keep-alive-pakketten uitschakelen 1: Verzenden van keep-alive-pakketten inschakelen
Uitvoerformaat	0
OutputBuffer-	NUL
OutputSizeReturned	NUL

Als u de status van deze socketoptie wilt ophalen, roept een WSK-toepassing de WskControlSocket- functie aan met de volgende parameters.

Parameter	Waarde
RequestType	WskGetOption
ControlCode-	SO_KEEPALIVE
niveau	SOL_SOCKET
InvoerGrootte	0
Invoerbuffer	NUL
Uitvoerformaat	sizeof(ULONG)
OutputBuffer-	Een aanwijzer naar een ULONG-variabele die de waarde van de status van de socketoptie ontvangt: 0: Het verzenden van keep-alive pakketten is uitgeschakeld 1: Het verzenden van keep alive-pakketten is ingeschakeld
OutputSizeReturned	NUL

Een WSK-toepassing moet een aanwijzer naar een IRP opgeven bij het aanroepen van de functie WskControlSocket om de status van de SO_KEEPALIVE socketoptie in te stellen of op te halen.

De standaardstatus van deze socketoptie is dat het verzenden van keep alive-pakketten is uitgeschakeld.

Als deze socketoptie is ingeschakeld op een luistersocket, zijn voor alle binnenkomende verbindingen die worden geaccepteerd op die luistersocket standaard deze socketoptie ingeschakeld. Een WSK-toepassing kan de functie WskControlSocket aanroepen op een geaccepteerde socket om de status van deze socketoptie te overschrijven die is overgenomen van de luistersocket.

Keep-alive-pakketten worden verzonden door het onderliggende netwerktransport. Niet alle netwerktransporten ondersteunen het verzenden van keep-alive pakketten.

Zie RFC 1122, sectie 4.2.3.6, 'TCP Keep-Alives', voor meer informatie over het gebruik van keep-alives.

Eisen

Versie	Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen.
Koptekst	Ws2def.h (inclusief Wsk.h)