SO_KEEPALIVE

O estado da opção de soquete SO_KEEPALIVE determina se os pacotes keep alive são enviados em um soquete orientado à conexão. Essa opção de soquete se aplica somente a soquetes de escuta e soquetes orientados à conexão.

Para definir o estado dessa opção de soquete, um aplicativo WSK chama a função WskControlSocket com os parâmetros a seguir.

Parâmetro	Valor
RequestType	WskSetOption
ControlCode	SO_KEEPALIVE
Level	SOL_SOCKET
InputSize	sizeof(ULONG)
Inputbuffer	Um ponteiro para uma variável do tipo ULONG que contém o valor para o novo estado da opção de soquete: 0: Desabilitar o envio de pacotes keep alive 1: Habilitar o envio de pacotes keep alive
OutputSize	0
OutputBuffer	NULO
OutputSizeReturned	NULO

Para recuperar o estado dessa opção de soquete, um aplicativo WSK chama a função WskControlSocket com os parâmetros a seguir.

Parâmetro	Valor
RequestType	WskGetOption
ControlCode	SO_KEEPALIVE
Level	SOL_SOCKET
InputSize	0
Inputbuffer	NULO
OutputSize	sizeof(ULONG)
OutputBuffer	Um ponteiro para uma variável do tipo ULONG que recebe o valor do estado da opção de soquete: 0: O envio de pacotes keep alive está desabilitado 1: O envio de pacotes keep alive está habilitado
OutputSizeReturned	NULO

Um aplicativo WSK deve especificar um ponteiro para um IRP ao chamar a função WskControlSocket para definir ou recuperar o estado da opção de soquete SO_KEEPALIVE.

O estado padrão dessa opção de soquete é que o envio de pacotes keep alive está desabilitado.

Se essa opção de soquete estiver habilitada em um soquete de escuta, todas as conexões de entrada aceitas nesse soquete de escuta terão essa opção de soquete habilitada por padrão. Um aplicativo WSK pode chamar a função WskControlSocket em um soquete aceito para substituir o estado dessa opção de soquete herdada do soquete de escuta.

Os pacotes keep alive são enviados pelo transporte de rede subjacente. Nem todos os transportes de rede dão suporte ao envio de pacotes keep alive.

Para obter mais informações sobre como usar pacotes keep alive, consulte RFC 1122, seção 4.2.3.6, "TCP Keep-Alives".

Requisitos

Versão	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
parâmetro	Ws2def.h (inclua Wsk.h)