SocketOptionName Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет имена параметров конфигурации.
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. Этот параметр может быть установлен только один раз, и после этого он не может быть отключен. |
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. Этот параметр может быть установлен только один раз, и после этого он не может быть отключен. |
FastOpen | 15 | |
HeaderIncluded | 2 | Указывает, что приложение обеспечивает IP-заголовок для исходящих датаграмм. |
HopLimit | 21 | Указывает максимальное количество прыжков маршрутизатора для IPv6-пакетов. Аналогично сроку жизни для протокола IPv4. |
IPOptions | 1 | Задает IP-параметры, которые включаются в исходящие датаграммы. |
IPProtectionLevel | 23 | Включает ограничение сокета IPv6 для указанного область, например адресов с тем же локальным префиксом ссылки или локального сайта. Этот параметр сокета позволяет приложениям накладывать ограничения доступа к сокетам IPv6. Такие ограничения позволяют приложению, работающему в частной локальной сети, просто и надежно защититься от внешних атак. Этот параметр сокета расширяет или сужает диапазон прослушивающего сокета, обеспечивая при необходимости неограниченный доступ со стороны открытых и закрытых пользователей или ограничивая доступ только тем же сайтом. Определенные уровни защиты этого параметра сокета указаны в перечислении IPProtectionLevel. |
IpTimeToLive | 4 | Задает поле срока жизни в IP-заголовке. |
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 | Использовать поддержание активности. |
Linger | 128 | Задержка при закрытии, если имеются неотправленные данные. |
MaxConnections | 2147483647 | Не поддерживается; при попытке использования возникает исключение SocketException. |
MulticastInterface | 9 | Задает интерфейс для исходящих пакетов многоадресной рассылки. |
MulticastLoopback | 11 | Замыкание на себя многоадресной IP-рассылки. |
MulticastTimeToLive | 10 | Срок жизни многоадресной IP-рассылки. |
NoChecksum | 1 | Отправить 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-подключение будет ожидать ответа на KeepAlive перед отправкой другой проверки на KeepAlive. |
TcpKeepAliveRetryCount | 16 | Число проверок активности протокола TCP, которые будут отправлены до завершения подключения. |
TcpKeepAliveTime | 3 | Время в секундах, в течение которого TCP-подключение будет оставаться активным, прежде чем проверки активности будут отправлены на удаленный объект. |
Type | 4104 | Получает тип сокета. |
TypeOfService | 3 | Изменить тип IP-заголовка служебного поля. |
UnblockSource | 18 | Разблокировать предварительно заблокированный источник. |
UpdateAcceptContext | 28683 | Обновляет свойства принятого сокета, используя свойства существующего сокета. Это эквивалентно применению параметра сокета Winsock2 SO_UPDATE_ACCEPT_CONTEXT и поддерживается только для сокетов, ориентированных на подключение. |
UpdateConnectContext | 28688 | Обновляет свойства подключенного сокета, используя свойства существующего сокета. Это эквивалентно применению параметра сокета Winsock2 SO_UPDATE_CONNECT_CONTEXT и поддерживается только для сокетов, ориентированных на подключение. |
UseLoopback | 64 | Не использовать оборудование, когда это возможно. |
Примеры
В следующем примере кода это перечисление используется для задания параметров сокета.
// 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);
// The socket will linger for 10 seconds after Socket.Close is called.
var lingerOption = new LingerOption(true, 10);
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption);
' 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 метода .
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по