LPWSPSETSOCKOPT

LPWSPSetSockOpt 関数は、ソケットオプションを設定します。

エラーが発生しなかった場合、LPWSPSetSockOpt は 0 を返します。それ以外の場合は SOCKET_ERROR が返され、具体的なエラーコードは lpErrno で取得できます。

LPWSPSetSockOpt 関数は、任意の種類および任意の状態のソケットに関連付けられたソケットオプションの現在の値を設定します。オプションは複数のプロトコルレベルに存在し得ますが、常に最上位のソケットレベルに存在します。オプションは、ソケット上でブロードキャストメッセージを送信できるかどうかなど、ソケットの動作に影響します。

ソケットオプションには 2 種類あります。機能や動作を有効または無効にするブール型のオプションと、整数値または構造体を必要とするオプションです。ブール型のオプションを有効にするには、optval が 0 以外の整数を指すようにします。オプションを無効にするには、optval が 0 に等しい整数を指すようにします。ブール型のオプションの場合、optlen パラメーターは sizeof (int) と等しくする必要があります。その他のオプションでは、optval はそのオプションに設定する値を格納した整数または構造体を指し、optlen はその整数または構造体の長さになります。

ソケットオプションの詳細については、Socket Options を参照してください。

level = SOL_SOCKET

サポートされていないオプションを指定して LPWSPGetSockopt を呼び出すと、lpErrno にエラーコード WSAENOPROTOOPT が返されます。

SO_DEBUG

Windows Sockets サービスプロバイダーは、Windows Sockets SPI クライアントによって SO_DEBUG オプションが設定された場合にデバッグ情報を出力することが推奨されますが、必須ではありません。デバッグ情報を生成する仕組みとその形式は、この仕様の対象外です。

SO_GROUP_PRIORITY

予約されています。

SO_KEEPALIVE

Windows Sockets SPI クライアントは、SO_KEEPALIVE ソケットオプションを有効にすることで、TCP 接続でキープアライブパケットを使用するよう TCP/IP プロバイダーに要求できます。Windows Sockets プロバイダーはキープアライブの使用をサポートする必要はありません。サポートする場合、正確なセマンティクスは実装固有ですが、RFC 1122 のセクション 4.2.3.6 Requirements for Internet Hosts—Communication Layers に準拠する必要があります (このリソースは英語のみで提供される場合があります)。キープアライブの結果として接続が切断された場合、そのソケットで進行中のすべての呼び出しにはエラーコード WSAENETRESET が返され、以降の呼び出しは WSAENOTCONN で失敗します。

SO_LINGER

SO_LINGER は、ソケットに未送信のデータがキューイングされている状態で LPWSPCloseSocket が実行されたときの動作を制御します。SO_LINGER の設定が LPWSPCloseSocket のセマンティクスにどのように影響するかについては、LPWSPCloseSocket の説明を参照してください。Windows Sockets SPI クライアントは、optval パラメーターが指す LINGER 構造体を次の要素で作成し、目的の動作を設定します。

struct linger {
  u_short l_onoff;
  u_short l_linger;
}

SO_LINGER を有効にするには、Windows Sockets SPI クライアントは l_onoff に 0 以外の値を設定し、l_linger に 0 または目的のタイムアウト値 (秒単位) を設定して、LPWSPSetSockOpt を呼び出します。SO_DONTLINGER を有効にする (つまり SO_LINGER を無効にする) には、l_onoff を 0 に設定して LPWSPSetSockOpt を呼び出します。非ブロッキングソケットで 0 以外のタイムアウト値を指定して SO_LINGER を有効にすることは推奨されない点に注意してください。詳細については、LPWSPCloseSocket を参照してください。

SO_LINGER を有効にすると SO_DONTLINGER は無効になり、その逆も同様です。SO_DONTLINGER が無効な場合 (つまり SO_LINGER が有効な場合)、タイムアウト値は指定されない点に注意してください。この場合に使用されるタイムアウトは実装依存です。以前にそのソケットに対して (SO_LINGER を有効にすることで) タイムアウトが設定されていた場合、サービスプロバイダーはそのタイムアウト値を再設定する必要があります。

SO_REUSEADDR

既定では、ソケットを既に使用されているローカルアドレスにバインドする (詳細については LPWSPBind を参照) ことはできません。しかし、このような形でアドレスを再利用することが望ましい場合もあります。各接続はローカルアドレスとリモートアドレスの組み合わせによって一意に識別されるため、リモートアドレスが異なる限り、2 つのソケットが同じローカルアドレスにバインドされていても問題はありません。別のソケットが既に使用しているローカルアドレスへのバインドをソケットの LPWSPBind で許可することを Windows Sockets プロバイダーに通知するには、Windows Sockets SPI クライアントは LPWSPBind を発行する前に、そのソケットに SO_REUSEADDR ソケットオプションを設定します。このオプションは LPWSPBind の時点でのみ解釈される点に注意してください。したがって、既存のアドレスにバインドしないソケットにこのオプションを設定することは不要ですが無害であり、LPWSPBind の後にこのオプションを設定またはリセットしても、そのソケットにも他のソケットにも影響しません。

SO_SNDBUF

Windows Sockets の実装が SO_RCVBUF および SO_SNDBUF オプションをサポートしている場合、Windows Sockets SPI クライアントは異なるバッファーサイズ (より大きいサイズまたはより小さいサイズ) を要求できます。サービスプロバイダーが要求された量をすべて提供しなかった場合でも、この呼び出しは成功することがあります。Windows Sockets SPI クライアントは、実際に提供されたバッファーサイズを確認するために、同じオプションを指定して LPWSPGetSockopt を呼び出す必要があります。

PVD_CONFIG

このオブジェクトは、ソケット s に関連付けられたサービスプロバイダーの構成情報を格納します。このデータ構造の正確な形式は、サービスプロバイダー固有です。