SocketOptionName 列挙型
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
構成オプション名を定義します。
public enum class SocketOptionName
public enum SocketOptionName
type SocketOptionName =
Public Enum SocketOptionName
- 継承
フィールド
AcceptConnection | 2 | ソケットはリッスンしています。 |
AddMembership | 12 | IP グループ メンバーシップを追加します。 |
AddSourceMembership | 15 | ソース グループを結合します。 |
BlockSource | 17 | ソースからデータをブロックします。 |
Broadcast | 32 | ソケットでのブロードキャスト メッセージの送信を許可します。 |
BsdUrgent | 2 | RFC-1222 の定義に従って、緊急データを使用します。 このオプションは 1 回だけ設定できます。いったん設定すると、オフにすることはできません。 |
ChecksumCoverage | 20 | UDP チェックサム カバレッジを設定または取得します。 |
Debug | 1 | デバッグ情報を記録します。 |
DontFragment | 14 | IP データグラムを断片化しないようにします。 |
DontLinger | -129 | 接続を維持せずに、ソケットを適切に閉じます。 |
DontRoute | 16 | インターフェイス アドレスにルーティングしたり、直接パケットを送信したりしません。 |
DropMembership | 13 | IP グループ メンバーシップを無効にします。 |
DropSourceMembership | 16 | ソース グループを無効にします。 |
Error | 4103 | エラー ステータスを取得し、クリアします。 |
ExclusiveAddressUse | -5 | ソケットを排他アクセス用にバインドできるようにします。 |
Expedited | 2 | RFC-1222 の定義に従って、優先データを使用します。 このオプションは 1 回だけ設定できます。いったん設定すると、オフにすることはできません。 |
HeaderIncluded | 2 | アプリケーションが発信データグラムに IP ヘッダーを提供していることを示します。 |
HopLimit | 21 | インターネット プロトコル Version 6 (IPv6) パケットのルーターの最大ホップ数を指定します。 これは、インターネット プロトコル Version 4 の有効期間 (TTL) のようなものです。 |
IPOptions | 1 | 発信データグラムに挿入する IP オプションを指定します。 |
IPProtectionLevel | 23 | 同じリンク ローカルまたはサイト ローカル プレフィックスを持つアドレスなど、指定されたスコープに対する IPv6 ソケットの制限を有効にします。 このソケット オプションを使用すると、アプリケーションは IPv6 ソケットにアクセス制限を適用できます。 この制限により、プライベート LAN で実行されるアプリケーションを外部からの攻撃に対して簡単かつ堅牢に強化できます。 このソケット オプションで待機中のソケットのスコープを変更して、適切な場合はパブリック ユーザーおよびプライベート ユーザーからの無制限のアクセスを許可したり、必要に応じて同じサイトへのアクセスのみに制限したりできます。 このソケット オプションには、IPProtectionLevel 列挙型で指定されている定義済みの保護レベルが設定されています。 |
IpTimeToLive | 4 | IP ヘッダーの Time-to-Live (有効期間) フィールドを設定します。 |
IPv6Only | 27 | AF_INET6 アドレス ファミリ用に作成されたソケットが IPv6 通信のみに制限されるかどうかを示します。 AF_INET6 アドレス ファミリ用に作成されたソケットは、IPv6 通信と IPv4 通信の両方に使用できます。 アプリケーションによっては、AF_INET6 アドレス ファミリ用に作成されたソケットの使用を IPv6 通信のみに制限する必要があります。 この値がゼロ以外の場合 (Windows での既定値)、AF_INET6 アドレス ファミリ用に作成されたソケットは、IPv6 パケットの送受信のみに使用できます。 この値がゼロの場合、AF_INET6 アドレス ファミリ用に作成されたソケットは、IPv6 アドレスまたは IPv4 アドレスとのパケットの送受信に使用できます。 IPv4 アドレスとやり取りできるようにするには、IPv4 でマップされたアドレスを使用する必要があります。 このソケット オプションは、Windows Vista 以降でサポートされています。 |
KeepAlive | 8 | Keep-alive を使用します。 |
Linger | 128 | 未送信のデータが存在する場合は、閉じた後も接続を維持します。 |
MaxConnections | 2147483647 | サポートされていません。使用すると SocketException がスローされます。 |
MulticastInterface | 9 | 発信マルチキャスト パケットのインターフェイスを設定します。 |
MulticastLoopback | 11 | IP マルチキャスト ループバック。 |
MulticastTimeToLive | 10 | IP マルチキャストの有効期間。 |
NoChecksum | 1 | チェックサムを 0 に設定して UDP データグラムを送信します。 |
NoDelay | 1 | 送信結合用の Nagle アルゴリズムを無効にします。 |
OutOfBandInline | 256 | 通常のデータ ストリーム内の帯域外データを受信します。 |
PacketInformation | 19 | 受信したパケットに関する情報を返します。 |
ReceiveBuffer | 4098 | 受信用に予約するソケット単位の合計バッファー領域を指定します。 これは最大メッセージ サイズまたは TCP ウィンドウのサイズとは関係ありません。 |
ReceiveLowWater | 4100 | Receive 操作の下限値を指定します。 |
ReceiveTimeout | 4102 | タイムアウトを受信します。このオプションは同期メソッドにのみ適用されます。メソッドなどの BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) 非同期メソッドには影響しません。 |
ReuseAddress | 4 | 既に使用されているアドレスにソケットをバインドすることを許可します。 |
ReuseUnicastPort | 12295 | 発信接続用の一時的なポート割り当てにシステムが従う必要があることを示します。 これは、Winsock2 SO_REUSE_UNICASTPORT ソケット オプションを使用することに相当します。 |
SendBuffer | 4097 | 送信用に予約するソケット単位の合計バッファー領域を指定します。 これは最大メッセージ サイズまたは TCP ウィンドウのサイズとは関係ありません。 |
SendLowWater | 4099 | Send 操作の下限値を指定します。 |
SendTimeout | 4101 | タイムアウトを送信します。このオプションは同期メソッドにのみ適用されます。メソッドなどの BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) 非同期メソッドには影響しません。 |
TcpKeepAliveInterval | 17 | TCP 接続が別のキープアライブ プローブを送信するまでにキープアライブ応答を待機する秒数。 |
TcpKeepAliveRetryCount | 16 | 接続が終了するまでに送信される TCP キープアライブ プローブの数。 |
TcpKeepAliveTime | 3 | TCP 接続がアライブ/アイドル状態になってからキープアライブ プローブがリモートに送信されるまでの秒数。 |
Type | 4104 | ソケット タイプを取得します。 |
TypeOfService | 3 | IP ヘッダーの Type of Service フィールドを変更します。 |
UnblockSource | 18 | 以前にブロックしたソースのブロックを解除します。 |
UpdateAcceptContext | 28683 | 既存のソケットのプロパティを使用して、受け入れられたソケットのプロパティを更新します。 これは、Winsock2 SO_UPDATE_ACCEPT_CONTEXT ソケット オプションを使用することに相当し、接続指向のソケットでだけサポートされています。 |
UpdateConnectContext | 28688 | 既存のソケットのプロパティを使用して、接続されたソケットのプロパティを更新します。 これは、Winsock2 SO_UPDATE_CONNECT_CONTEXT ソケット オプションを使用することに相当し、接続指向のソケットでだけサポートされています。 |
UseLoopback | 64 | 可能な場合はハードウェアをバイパスします。 |
例
次のコード例では、この列挙を使用してソケット オプションを設定します。
// Specifies that send operations will time-out
// if confirmation is not received within 1000 milliseconds.
s->SetSocketOption( SocketOptionLevel::Socket, SocketOptionName::SendTimeout, 1000 );
// Specifies that the Socket will linger for 10 seconds after Close is called.
LingerOption^ lingerOption = gcnew LingerOption( true,10 );
s->SetSocketOption( SocketOptionLevel::Socket, SocketOptionName::Linger, lingerOption );
// Send operations will time-out if confirmation
// is not received within 1000 milliseconds.
s.SetSocketOption (SocketOptionLevel.Socket, SocketOptionName.SendTimeout, 1000);
// The socket will linger for 10 seconds after Socket.Close is called.
LingerOption lingerOption = new LingerOption (true, 10);
s.SetSocketOption (SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption);
'Send operations will time-out if confirmation is
' not received within 1000 milliseconds.
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.SendTimeout, 1000)
' The socket will linger for 10 seconds after Socket.Close is called.
Dim lingerOption As New LingerOption(True, 10)
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption)
注釈
列挙は SocketOptionName 、各 Socket 構成オプションの名前を定義します。 ソケットは、メソッドを使用して Socket.SetSocketOption 構成できます。