Partilhar via


SO_KEEPALIVE

O estado da opção de soquete SO_KEEPALIVE determina se os pacotes keep-alive são enviados em um soquete orientado para conexão.) Esta opção de socket aplica-se apenas a sockets de escuta e sockets orientados para ligação.

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

Parâmetro Valor

RequestType

WskSetOption

ControlCode

SO_KEEPALIVE

Nível

SOL_SOCKET

InputSize

tamanho de (ULONG)

Buffer de Entrada

Um ponteiro para uma variável tipo ULONG que contém o valor para o novo estado da opção de soquete:

  • 0: Desative o envio de pacotes keep-alive

  • 1: Ativar o envio de pacotes keep-alive

TamanhoDeSaída

0

Buffer de Saída

NULO

OutputSizeReturned

NULO

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

Parâmetro Valor

RequestType

WskGetOption

ControlCode

SO_KEEPALIVE

Nível

SOL_SOCKET

InputSize

0

Buffer de Entrada

NULO

TamanhoDeSaída

tamanho de (ULONG)

Buffer de Saída

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á desativado

  • 1: O envio de pacotes keep-alive está ativado

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. Uma aplicação WSK pode chamar a função WskControlSocket num socket aceito para alterar o estado desta opção de socket que foi herdada do socket de escuta.

Os pacotes Keep-alive são enviados pelo transporte de rede subjacente. Nem todos os transportes de rede suportam o 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".

Requerimentos

Versão

Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.

Cabeçalho

Ws2def.h (inclui Wsk.h)