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:
|
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:
|
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) |