IOControlCode 枚举

定义

命名空间:

System.Net.Sockets

程序集:

System.Net.Sockets.dll

指定 IOControl(Int32, Byte[], Byte[]) 方法支持的 IO 控制代码。

public enum class IOControlCode

public enum IOControlCode

type IOControlCode = 

Public Enum IOControlCode

继承

Object

ValueType

Enum

IOControlCode

字段

AbsorbRouterAlert	2550136837	此值等于 Winsock 2 SIO_ABSORB_RTRALERT 常数。
AddMulticastGroupOnInterface	2550136842	使用按索引标识的接口联接多播组。 此值等于 Winsock 2 SIO_INDEX_ADD_MCAST 常数。
AddressListChange	671088663	当套接字协议族的本地接口列表更改时启用接收通知。 此值等于 Winsock 2 SIO_ADDRESS_LIST_CHANGE 常数。
AddressListQuery	1207959574	返回套接字可绑定到的本地接口列表。 此值等于 Winsock 2 SIO_ADDRESS_LIST_QUERY 常数。
AddressListSort	3355443225	对 AddressListQuery 字段返回的结构进行排序，并为 IPv6 地址添加范围 ID 信息。 Windows XP 及更高版本的操作系统支持此控制代码。 此值等于 Winsock 2 SIO_ADDRESS_LIST_SORT 常数。
AssociateHandle	2281701377	将此套接字与附带接口的指定句柄关联。 有关其他详细信息，请参阅 Winsock 2 参考或文档中特定于协议的相应附件，了解特定配套接口。 建议使用组件对象模型 (COM) 代替此 IOCTL，以发现并跟踪套接字可能支持的其他接口。 此控制代码是为了与某些系统保持向后兼容而提供的，在这些系统中，COM 不可用或由于某些其他原因而无法使用。 此值等于 Winsock 2 SIO_ASSOCIATE_HANDLE 常数。
AsyncIO	2147772029	当等待接收数据时启用通知。 此值等于 Winsock 2 FIOASYNC 常数。
BindToInterface	2550136840	将套接字绑定到指定的接口索引。 此值等于 Winsock 2 SIO_INDEX_BIND 常数。
DataToRead	1074030207	返回可读取的字节数。 此值等于 Winsock 2 FIONREAD 常数。
DeleteMulticastGroupFromInterface	2550136843	从多播组中移除套接字。 此值等于 Winsock 2 SIO_INDEX_ADD_MCAST 常数。
EnableCircularQueuing	671088642	当传入的消息队列已满时，将时间最久的已排队数据报替换为传入的数据报。 此值等于 Winsock 2 SIO_ENABLE_CIRCULAR_QUEUEING 常数。
Flush	671088644	放弃发送队列的内容。 此值等于 Winsock 2 SIO_FLUSH 常数。
GetBroadcastAddress	1207959557	返回一个 SOCKADDR 结构，该结构包含当前套接字地址族的广播地址。 返回的地址可与 SendTo 方法一起使用。 此值等于 Winsock 2 SIO_GET_BROADCAST_ADDRESS 常数。 此值仅可用于用户数据报协议 (UDP) 套接字。
GetExtensionFunctionPointer	3355443206	获取提供程序特定的函数，这类函数不是 Winsock 规范的一部分。 这些函数通过使用其提供程序分配的 GUID 进行指定。 此值等于 Winsock 2 SIO_GET_EXTENSION_FUNCTION_POINTER 常数。
GetGroupQos	3355443208	返回套接字组的服务质量 (QOS) 特性。 此值保留供将来使用，并且等于 Winsock 2 SIO_GET_GROUP_QOS 常数。
GetQos	3355443207	检索与套接字关联的 QOS 结构。 此值等于 Winsock 2 SIO_GET_QOS 常数。
KeepAliveValues	2550136836	控制 TCP Keep-Alive 数据包的发送以及发送间隔。 有关其他信息，请参阅 RFC 1122 的 4.2.3.6 节。 此值等于 Winsock 2 SIO_KEEPALIVE_VALS 常数。
LimitBroadcasts	2550136839	此值等于 Winsock 2 SIO_LIMIT_BROADCASTS 常数。
MulticastInterface	2550136841	设置用于传出多播数据包的接口。 该接口由索引进行标识。 此值等于 Winsock 2 SIO_INDEX_MCASTIF 常数。
MulticastScope	2281701386	控制路由器可以转发多播数据包的次数，也称作生存时间 (TTL) 或跃点计数。 此值等于 Winsock 2 SIO_MULTICAST_SCOPE 常数。
MultipointLoopback	2281701385	控制套接字发送的多播数据是否在套接字接收队列中显示为传入数据。 此值等于 Winsock 2 SIO_MULTIPOINT_LOOPBACK 常数。
NamespaceChange	2281701401	控制套接字是否在命名空间查询无效时接收通知。 Windows XP 及更高版本的操作系统支持此控制代码。 此值等于 Winsock 2 SIO_NSP_NOTIFY_CHANGE 常数。
NonBlockingIO	2147772030	控制套接字的阻止行为。 如果使用此控制代码指定的参数为零，套接字置于阻止模式下。 如果参数不为零，套接字置于非阻止模式下。 此值等于 Winsock 2 FIONBIO 常数。
OobDataRead	1074033415	返回有关等待接收的带外数据的信息。 在流式套接字上使用此控制代码时，返回值指示可用的字节数。
QueryTargetPnpHandle	1207959576	检索基础提供程序的 SOCKET 句柄。 此句柄可用于接收即插即用事件通知。 此值等于 Winsock 2 SIO_QUERY_TARGET_PNP_HANDLE 常数。
ReceiveAll	2550136833	支持接收网络上的所有 IPv4 数据包。 套接字必须有 InterNetwork 地址族，套接字类型必须是 Raw，并且协议类型必须为 IP。 当前用户必须属于本地计算机上的管理员组，并且套接字必须绑定到特定端口。 此值等于 Winsock 2 SIO_RCVALL 常数。
ReceiveAllIgmpMulticast	2550136835	支持接收网络上所有 Internet 组管理协议 (IGMP) 数据包。 套接字必须有 InterNetwork 地址族，套接字类型必须是 Raw，并且协议类型必须为 Igmp。 当前用户必须属于本地计算机上的管理员组，并且套接字必须绑定到特定端口。 此值等于 Winsock 2 SIO_RCVALL_IGMPMCAST 常数。
ReceiveAllMulticast	2550136834	支持接收网络上所有多播 IPv4 数据包。 这些数据包的目标地址范围介于 224.0.0.0 到 239.255.255.255 之间。 套接字必须有 InterNetwork 地址族，套接字类型必须是 Raw，并且协议类型必须为 Udp。 当前用户必须属于本地计算机上的管理员组，并且套接字必须绑定到特定端口。 此值等于 Winsock 2 SIO_RCVALL_MCAST 常数。
RoutingInterfaceChange	2281701397	支持在用于访问远程终结点的本地接口更改时接收通知。 此值等于 Winsock 2 SIO_ROUTING_INTERFACE_CHANGE 常数。
RoutingInterfaceQuery	3355443220	返回可用于连接到指定远程地址的接口地址。 此值等于 Winsock 2 SIO_ROUTING_INTERFACE_QUERY 常数。
SetGroupQos	2281701388	设置套接字组的服务质量 (QOS) 特性。 此值保留供将来使用，并且等于 Winsock 2 SIO_SET_GROUP_QOS 常数。
SetQos	2281701387	设置套接字的服务质量 (QOS) 特性。 QOS 用于定义套接字的带宽要求。 此值等于 Winsock 2 SIO_SET_QOS 常数。
TranslateHandle	3355443213	返回附带接口上下文中有效套接字的句柄。 此值等于 Winsock 2 SIO_TRANSLATE_HANDLE 常数。
UnicastInterface	2550136838	设置用于传出单播数据包的接口。 此值等于 Winsock 2 SIO_UCAST_IF 常数。

示例

下面的代码示例使用 DataToRead 参数值调用 IOControl(IOControlCode, Byte[], Byte[]) 方法，并将结果与访问Available 属性进行比较。

void DisplayPendingByteCount( Socket^ s )
{
   array<Byte>^ outValue = BitConverter::GetBytes( 0 );
   
   // Check how many bytes have been received.
   s->IOControl( IOControlCode::DataToRead, nullptr, outValue );

   UInt32 bytesAvailable = BitConverter::ToUInt32( outValue, 0 );
   Console::Write( "server has {0} bytes pending,",
      bytesAvailable );
   Console::WriteLine( "Available property says {1}.",
      s->Available );
   return;
}

static void DisplayPendingByteCount(Socket s)
{
    byte[] outValue = BitConverter.GetBytes(0);

    // Check how many bytes have been received.
    s.IOControl(IOControlCode.DataToRead, null, outValue);

    uint bytesAvailable = BitConverter.ToUInt32(outValue, 0);
    Console.Write("server has {0} bytes pending. ",
        bytesAvailable);
    Console.WriteLine("Available property says {1}.",
                     s.Available);

    return;
}

注解

IOControlCode枚举提供用于指定套接字操作模式的命名值。 这些值是传递给 Windows 套接字 2 (Winsock 2) 函数的控制 WSAIoctl 代码。