SO_KEEPALIVE

L’état de l’option de socket SO_KEEPALIVE détermine si les paquets keep-alive sont envoyés sur un socket orienté connexion. Cette option de socket s’applique uniquement aux sockets d’écoute et aux sockets orientés connexion.

Pour définir l’état de cette option de socket, une application WSK appelle la fonction WskControlSocket avec les paramètres suivants.

Paramètre	Valeur
RequestType	WskSetOption
ControlCode	SO_KEEPALIVE
Niveau	SOL_SOCKET
InputSize	sizeof(ULONG)
InputBuffer	Pointeur vers une variable de type ULONG qui contient la valeur du nouvel état de l’option de socket : 0 : Désactiver l’envoi de paquets keep-alive 1 : Activer l’envoi de paquets keep-alive
OutputSize	0
OutputBuffer	NULL
OutputSizeReturned	NULL

Pour récupérer l’état de cette option de socket, une application WSK appelle la fonction WskControlSocket avec les paramètres suivants.

Paramètre	Valeur
RequestType	WskGetOption
ControlCode	SO_KEEPALIVE
Niveau	SOL_SOCKET
InputSize	0
InputBuffer	NULL
OutputSize	sizeof(ULONG)
OutputBuffer	Pointeur vers une variable de type ULONG qui reçoit la valeur de l’état de l’option de socket : 0 : l’envoi de paquets keep-alive est désactivé 1 : l’envoi de paquets keep-alive est activé
OutputSizeReturned	NULL

Une application WSK doit spécifier un pointeur vers un IRP lors de l’appel de la fonction WskControlSocket pour définir ou récupérer l’état de l’option de socket SO_KEEPALIVE.

L’état par défaut de cette option de socket est que l’envoi de paquets keep-alive est désactivé.

Si cette option de socket est activée sur un socket d’écoute, toutes les connexions entrantes acceptées sur ce socket d’écoute ont cette option de socket activée par défaut. Une application WSK peut appeler la fonction WskControlSocket sur un socket accepté pour remplacer l’état de cette option de socket héritée du socket d’écoute.

Les paquets keep-alive sont envoyés par le transport réseau sous-jacent. Tous les transports réseau ne prennent pas en charge l’envoi de paquets keep-alive.

Pour plus d’informations sur l’utilisation des paquets keep-alive, consultez RFC 1122, section 4.2.3.6, « TCP Keep-Alives ».

Spécifications

Version	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
En-tête	Ws2def.h (inclure Wsk.h)