SO_KEEPALIVE
SO_K Enterprise Edition PALIVE ソケット オプションの状態は、キープアライブ パケットが接続指向ソケットで送信されるかどうかを決定します。 このソケット オプションは、リッスンしているソケットと接続指向のソケットにのみ適用されます。
このソケット オプションの状態を設定するために、WSK アプリケーションは次のパラメーターを使用して WskControlSocket 関数を呼び出します。
パラメーター | 値 |
---|---|
RequestType |
WskSetOption |
ControlCode |
SO_KEEPALIVE |
Level |
SOL_SOCKET |
InputSize |
sizeof(ULONG) |
InputBuffer |
ソケット オプションの新しい状態の値を含む ULONG 型の変数へのポインター。
|
OutputSize |
0 |
OutputBuffer |
NULL |
OutputSizeReturned |
NULL |
このソケット オプションの状態を設定するために、WSK アプリケーションは次のパラメーターを使用して WskControlSocket 関数を呼び出します。
パラメーター | 値 |
---|---|
RequestType |
WskGetOption |
ControlCode |
SO_KEEPALIVE |
Level |
SOL_SOCKET |
InputSize |
0 |
InputBuffer |
NULL |
OutputSize |
sizeof(ULONG) |
OutputBuffer |
ソケット オプションの状態の値を受け取る ULONG 型の変数へのポインター。
|
OutputSizeReturned |
NULL |
WSK アプリケーションは、wskControlSocket 関数を呼び出すときに IRP へのポインターを指定して、SO_KEEPALIVE ソケット オプションの状態を設定または取得する必要があります。
このソケット オプションの既定の状態は、キープアライブ パケットの送信が無効になっているということです。
このソケット オプションがリッスン ソケットで有効になっている場合、そのリッスン ソケットで受け入れられるすべての受信接続では、このソケット オプションが既定で有効になります。 WSK アプリケーションは、受け入れられたソケットで WskControlSocket 関数を呼び出して、リッスン しているソケットから継承されたこのソケット オプションの状態をオーバーライドできます。
キープアライブ パケットは、基になるネットワーク トランスポートによって送信されます。 すべてのネットワーク トランスポートがキープアライブ パケットの送信をサポートしているわけではありません。
キープアライブ パケットの使用の詳細については、RFC 1122、セクション 4.2.3.6「TCP Keep-Alives」を参照してください。
要件
バージョン |
Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ヘッダー |
Ws2def.h (Wsk.h を含む) |