Delen via


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)