SocketOptionName SocketOptionName SocketOptionName SocketOptionName Enum

Определение

Определяет имена параметров конфигурации.Defines configuration option names.

public enum class SocketOptionName
public enum SocketOptionName
type SocketOptionName = 
Public Enum SocketOptionName
Наследование
SocketOptionNameSocketOptionNameSocketOptionNameSocketOptionName

Поля

AcceptConnection AcceptConnection AcceptConnection AcceptConnection 2

Сокет прослушивает.The socket is listening.

AddMembership AddMembership AddMembership AddMembership 12

Добавить членство в IP-группе.Add an IP group membership.

AddSourceMembership AddSourceMembership AddSourceMembership AddSourceMembership 15

Присоединить группу источника.Join a source group.

BlockSource BlockSource BlockSource BlockSource 17

Блокировать данные из источника.Block data from a source.

Broadcast Broadcast Broadcast Broadcast 32

Разрешить отправку широковещательных сообщений в сокет.Permit sending broadcast messages on the socket.

BsdUrgent BsdUrgent BsdUrgent BsdUrgent 2

Использовать срочные данные в соответствии с определением стандарта RFC-1222.Use urgent data as defined in RFC-1222. Этот параметр может быть установлен только один раз, и после этого он не может быть отключен.This option can be set only once; after it is set, it cannot be turned off.

ChecksumCoverage ChecksumCoverage ChecksumCoverage ChecksumCoverage 20

Задать или получить контрольную сумму для протокола UDP.Set or get the UDP checksum coverage.

Debug Debug Debug Debug 1

Записать отладочную информацию.Record debugging information.

DontFragment DontFragment DontFragment DontFragment 14

Не фрагментировать IP-датаграммы.Do not fragment IP datagrams.

DontLinger DontLinger DontLinger DontLinger -129

Закрыть сокет правильно и без задержки.Close the socket gracefully without lingering.

DontRoute DontRoute DontRoute DontRoute 16

Не использовать маршрутизацию; отправлять пакет непосредственно на адреса интерфейса.Do not route; send the packet directly to the interface addresses.

DropMembership DropMembership DropMembership DropMembership 13

Сбросить членство в IP-группе.Drop an IP group membership.

DropSourceMembership DropSourceMembership DropSourceMembership DropSourceMembership 16

Отключить группу источника.Drop a source group.

Error Error Error Error 4103

Получает состояние ошибки и выполняет очистку.Gets the error status and clear.

ExclusiveAddressUse ExclusiveAddressUse ExclusiveAddressUse ExclusiveAddressUse -5

Включает для сокета ограничение на монопольный доступ.Enables a socket to be bound for exclusive access.

Expedited Expedited Expedited Expedited 2

Использовать срочные данные в соответствии с определением стандарта RFC-1222.Use expedited data as defined in RFC-1222. Этот параметр может быть установлен только один раз, и после этого он не может быть отключен.This option can be set only once; after it is set, it cannot be turned off.

HeaderIncluded HeaderIncluded HeaderIncluded HeaderIncluded 2

Указывает, что приложение обеспечивает IP-заголовок для исходящих датаграмм.Indicates that the application provides the IP header for outgoing datagrams.

HopLimit HopLimit HopLimit HopLimit 21

Указывает максимальное количество прыжков маршрутизатора для IPv6-пакетов.Specifies the maximum number of router hops for an Internet Protocol version 6 (IPv6) packet. Аналогично сроку жизни для протокола IPv4.This is similar to Time to Live (TTL) for Internet Protocol version 4.

IPOptions IPOptions IPOptions IPOptions 1

Задает IP-параметры, которые включаются в исходящие датаграммы.Specifies the IP options to be inserted into outgoing datagrams.

IPProtectionLevel IPProtectionLevel IPProtectionLevel IPProtectionLevel 23

Включает ограничение сокета IPv6 до указанной области, например до адресов с одинаковой локальной ссылкой или локальным префиксом сайта. Этот параметр сокета позволяет приложениям ограничивать доступ к сокетам IPv6.Enables restriction of a IPv6 socket to a specified scope, such as addresses with the same link local or site local prefix.This socket option enables applications to place access restrictions on IPv6 sockets. Такие ограничения позволяют приложению, работающему в частной локальной сети, просто и надежно защититься от внешних атак.Such restrictions enable an application running on a private LAN to simply and robustly harden itself against external attacks. Этот параметр сокета расширяет или сужает диапазон прослушивающего сокета, обеспечивая при необходимости неограниченный доступ со стороны открытых и закрытых пользователей или ограничивая доступ только тем же сайтом.This socket option widens or narrows the scope of a listening socket, enabling unrestricted access from public and private users when appropriate, or restricting access only to the same site, as required. Определенные уровни защиты этого параметра сокета указаны в перечислении IPProtectionLevel.This socket option has defined protection levels specified in the IPProtectionLevel enumeration.

IpTimeToLive IpTimeToLive IpTimeToLive IpTimeToLive 4

Задает поле срока жизни в IP-заголовке.Set the IP header Time-to-Live field.

IPv6Only IPv6Only IPv6Only IPv6Only 27

Указывает, ограничен ли сокет, созданный для семейства адресов AF_INET6, связью через IPv6.Indicates if a socket created for the AF_INET6 address family is restricted to IPv6 communications only. Сокеты, созданные для семейства адресов AF_INET6, можно использовать для связи и через IPv6, и через IPv4.Sockets created for the AF_INET6 address family may be used for both IPv6 and IPv4 communications. Некоторым приложениям может быть нужно ограничивать использование сокета, созданного для семейства адресов AF_INET6, связью через IPv6.Some applications may want to restrict their use of a socket created for the AF_INET6 address family to IPv6 communications only. Если это значение не равно нулю (по умолчанию в Windows), то сокет, созданный для семейства адресов AF_INET6, может использоваться для отправки и получения только пакетов IPv6.When this value is non-zero (the default on Windows), a socket created for the AF_INET6 address family can be used to send and receive IPv6 packets only. Если это значение равно нулю, сокет, созданный для семейства адресов AF_INET6, может использоваться для отправки и получения пакетов IPv6 и IPv4.When this value is zero, a socket created for the AF_INET6 address family can be used to send and receive packets to and from an IPv6 address or an IPv4 address. Обратите внимание, что возможность взаимодействия с адресами IPv4 требует использования адресов, сопоставленных по IPv4.Note that the ability to interact with an IPv4 address requires the use of IPv4 mapped addresses. Этот параметр сокета поддерживается в Windows Vista и более поздних версиях.This socket option is supported on Windows Vista or later.

KeepAlive KeepAlive KeepAlive KeepAlive 8

Использовать поддержание активности.Use keep-alives.

Linger Linger Linger Linger 128

Задержка при закрытии, если имеются неотправленные данные.Linger on close if unsent data is present.

MaxConnections MaxConnections MaxConnections MaxConnections 2147483647

Не поддерживается; при попытке использования возникает исключение SocketException.Not supported; will throw a SocketException if used.

MulticastInterface MulticastInterface MulticastInterface MulticastInterface 9

Задает интерфейс для исходящих пакетов многоадресной рассылки.Set the interface for outgoing multicast packets.

MulticastLoopback MulticastLoopback MulticastLoopback MulticastLoopback 11

Замыкание на себя многоадресной IP-рассылки.An IP multicast loopback.

MulticastTimeToLive MulticastTimeToLive MulticastTimeToLive MulticastTimeToLive 10

Срок жизни многоадресной IP-рассылки.An IP multicast Time to Live.

NoChecksum NoChecksum NoChecksum NoChecksum 1

Отправить UDP-датаграммы с контрольной суммой, заданной равной нулю.Send UDP datagrams with checksum set to zero.

NoDelay NoDelay NoDelay NoDelay 1

Отключить алгоритм Nagle для отправки объединенных пакетов.Disables the Nagle algorithm for send coalescing.

OutOfBandInline OutOfBandInline OutOfBandInline OutOfBandInline 256

Получает внешние данные в обычном потоке данных.Receives out-of-band data in the normal data stream.

PacketInformation PacketInformation PacketInformation PacketInformation 19

Возвратить сведения о полученных пакетах.Return information about received packets.

ReceiveBuffer ReceiveBuffer ReceiveBuffer ReceiveBuffer 4098

Задает общий размер буферного пространства сокета, которое зарезервировано для приема.Specifies the total per-socket buffer space reserved for receives. Это не связано с максимальным размером сообщения или с размером TCP-окна.This is unrelated to the maximum message size or the size of a TCP window.

ReceiveLowWater ReceiveLowWater ReceiveLowWater ReceiveLowWater 4100

Указывает отметку нижнего уровня для операций Receive.Specifies the low water mark for Receive operations.

ReceiveTimeout ReceiveTimeout ReceiveTimeout ReceiveTimeout 4102

Получить тайм-аут. Этот параметр применим только для синхронных методов; он не действует для асинхронных методов, таких как BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object).Receive a time-out. This option applies only to synchronous methods; it has no effect on asynchronous methods such as the BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) method.

ReuseAddress ReuseAddress ReuseAddress ReuseAddress 4

Позволяет ограничить сокет, разрешив только тот адрес, который уже используется.Allows the socket to be bound to an address that is already in use.

ReuseUnicastPort ReuseUnicastPort ReuseUnicastPort ReuseUnicastPort 12295

Указывает, что система должна отложить выделение временных портов для исходящих соединений.Indicates that the system should defer ephemeral port allocation for outbound connections. Это эквивалентно использованию параметра сокета Winsock2 SO_REUSE_UNICASTPORT.This is equivalent to using the Winsock2 SO_REUSE_UNICASTPORT socket option.

SendBuffer SendBuffer SendBuffer SendBuffer 4097

Задает общий размер буферного пространства сокета, которое зарезервировано для отправки.Specifies the total per-socket buffer space reserved for sends. Это не связано с максимальным размером сообщения или с размером TCP-окна.This is unrelated to the maximum message size or the size of a TCP window.

SendLowWater SendLowWater SendLowWater SendLowWater 4099

Указывает отметку нижнего уровня для операций Send.Specifies the low water mark for Send operations.

SendTimeout SendTimeout SendTimeout SendTimeout 4101

Отправить тайм-аут. Этот параметр применим только для синхронных методов; он не действует для асинхронных методов, таких как BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object).Send a time-out. This option applies only to synchronous methods; it has no effect on asynchronous methods such as the BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) method.

TcpKeepAliveInterval TcpKeepAliveInterval TcpKeepAliveInterval TcpKeepAliveInterval 17

Количество секунд, в течение которых TCP-подключение будет ожидать ответа на KeepAlive перед отправкой другой проверки на KeepAlive.The number of seconds a TCP connection will wait for a keepalive response before sending another keepalive probe.

TcpKeepAliveRetryCount TcpKeepAliveRetryCount TcpKeepAliveRetryCount TcpKeepAliveRetryCount 16

Число проверок активности протокола TCP, которые будут отправлены до завершения подключения.The number of TCP keep alive probes that will be sent before the connection is terminated.

TcpKeepAliveTime TcpKeepAliveTime TcpKeepAliveTime TcpKeepAliveTime 3

Время в секундах, в течение которого TCP-подключение будет оставаться активным, прежде чем проверки активности будут отправлены на удаленный объект.The number of seconds a TCP connection will remain alive/idle before keepalive probes are sent to the remote.

Type Type Type Type 4104

Получает тип сокета.Gets the socket type.

TypeOfService TypeOfService TypeOfService TypeOfService 3

Изменить тип IP-заголовка служебного поля.Change the IP header type of the service field.

UnblockSource UnblockSource UnblockSource UnblockSource 18

Разблокировать предварительно заблокированный источник.Unblock a previously blocked source.

UpdateAcceptContext UpdateAcceptContext UpdateAcceptContext UpdateAcceptContext 28683

Обновляет свойства принятого сокета, используя свойства существующего сокета.Updates an accepted socket's properties by using those of an existing socket. Это эквивалентно применению параметра сокета Winsock2 SO_UPDATE_ACCEPT_CONTEXT и поддерживается только для сокетов, ориентированных на подключение.This is equivalent to using the Winsock2 SO_UPDATE_ACCEPT_CONTEXT socket option and is supported only on connection-oriented sockets.

UpdateConnectContext UpdateConnectContext UpdateConnectContext UpdateConnectContext 28688

Обновляет свойства подключенного сокета, используя свойства существующего сокета.Updates a connected socket's properties by using those of an existing socket. Это эквивалентно применению параметра сокета Winsock2 SO_UPDATE_CONNECT_CONTEXT и поддерживается только для сокетов, ориентированных на подключение.This is equivalent to using the Winsock2 SO_UPDATE_CONNECT_CONTEXT socket option and is supported only on connection-oriented sockets.

UseLoopback UseLoopback UseLoopback UseLoopback 64

Не использовать оборудование, когда это возможно.Bypass hardware when possible.

Примеры

В следующем примере кода это перечисление используется для задания параметров сокета.The following code example uses this enumeration to set socket options.

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

Комментарии

Перечисление определяет имя каждого Socket параметра конфигурации. SocketOptionNameThe SocketOptionName enumeration defines the name of each Socket configuration option. Сокеты можно настроить с помощью Socket.SetSocketOption метода.Sockets can be configured with the Socket.SetSocketOption method.

Применяется к

Дополнительно