SocketOptionName Enum
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Definierar namn på konfigurationsalternativ.
public enum class SocketOptionName
public enum SocketOptionName
type SocketOptionName =
Public Enum SocketOptionName
- Arv
Fält
| Name | Värde | Description |
|---|---|---|
| DontLinger | -129 | Stäng sockeln graciöst utan att dröja kvar. |
| ExclusiveAddressUse | -5 | Gör att en socket kan bindas för exklusiv åtkomst. |
| Debug | 1 | Registrera felsökningsinformation. |
| IPOptions | 1 | Anger DE IP-alternativ som ska infogas i utgående datagram. |
| NoChecksum | 1 | Skicka UDP-datagram med kontrollsumman inställd på noll. |
| NoDelay | 1 | Inaktiverar Nagle-algoritmen för sammankoppling av meddelanden. |
| AcceptConnection | 2 | Socketen lyssnar. |
| BsdUrgent | 2 | Använd brådskande data enligt definitionen i RFC-1222. Det här alternativet kan bara anges en gång. När den har angetts kan den inte stängas av. |
| Expedited | 2 | Använd snabba data enligt definitionen i RFC-1222. Det här alternativet kan bara anges en gång. När den har angetts kan den inte stängas av. |
| HeaderIncluded | 2 | Anger att programmet tillhandahåller IP-huvudet för utgående datagram. |
| TypeOfService | 3 | Ändra IP-huvudtypen för tjänstfältet. |
| IpTimeToLive | 4 | Ange fältet Time-to-Live för IP-huvudet. |
| ReuseAddress | 4 | Tillåter att socketen är bunden till en adress som redan används. |
| KeepAlive | 8 | Använd keep-alives. |
| MulticastInterface | 9 | Ange gränssnittet för utgående multicast-paket. |
| MulticastTimeToLive | 10 | En IP-multicast-tid till live. |
| MulticastLoopback | 11 | En IP-multicast-loopback. |
| AddMembership | 12 | Lägg till ett IP-gruppmedlemskap. |
| DropMembership | 13 | Ta bort ett IP-gruppmedlemskap. |
| DontFragment | 14 | Fragmenta inte IP-datagram. |
| AddSourceMembership | 15 | Anslut till en källgrupp. |
| DontRoute | 16 | Dirigera inte; skicka paketet direkt till gränssnittsadresserna. |
| DropSourceMembership | 16 | Släpp en källgrupp. |
| BlockSource | 17 | Blockera data från en källa. |
| UnblockSource | 18 | Avblockera en tidigare blockerad källa. |
| PacketInformation | 19 | Returnera information om mottagna paket. |
| ChecksumCoverage | 20 | Ange eller hämta UDP-kontrollsummans täckning. |
| HopLimit | 21 | Anger det maximala antalet routerhopp för ett IPv6-paket (Internet Protocol version 6). Detta liknar TTL (Time to Live) för Internet Protocol version 4. |
| IPProtectionLevel | 23 | Aktiverar begränsning av en IPv6-socket till ett angivet omfång, till exempel adresser med samma lokala länk- eller platsprefix. Med det här socketalternativet kan program använda åtkomstbegränsningar för IPv6-socketar. Sådana begränsningar gör det möjligt för ett program som körs på ett privat LAN att enkelt och kraftfullt härda sig mot externa attacker. Det här socketalternativet breddar eller begränsar omfånget för en lyssningssocket, vilket möjliggör obegränsad åtkomst från offentliga och privata användare när det är lämpligt eller begränsar åtkomsten endast till samma plats efter behov. Det här socketalternativet har definierade skyddsnivåer som anges i IPProtectionLevel uppräkningen. |
| IPv6Only | 27 | Anger om en socket som skapats för AF_INET6-adressfamiljen endast är begränsad till IPv6-kommunikation. Sockets som skapats för AF_INET6-adressfamiljen kan användas för både IPv6- och IPv4-kommunikation. Vissa program kanske bara vill begränsa användningen av en socket som skapats för AF_INET6-adressfamiljen till IPv6-kommunikation. När det här värdet inte är noll (standardvärdet på Windows) kan en socket som skapats för AF_INET6-adressfamiljen användas för att endast skicka och ta emot IPv6-paket. När det här värdet är noll kan en socket som skapats för AF_INET6-adressfamiljen användas för att skicka och ta emot paket till och från en IPv6-adress eller en IPv4-adress. Observera att möjligheten att interagera med en IPv4-adress kräver användning av IPv4-mappade adresser. Det här socketalternativet stöds i Windows Vista eller senare. |
| Broadcast | 32 | Tillåt sändning av sändningsmeddelanden i socketen. |
| UseLoopback | 64 | Kringgå maskinvara när det är möjligt. |
| Linger | 128 | Dröj kvar vid stängning om det finns osedda data. |
| OutOfBandInline | 256 | Tar emot out-of-band-data i den normala dataströmmen. |
| SendBuffer | 4097 | Anger det totala buffertutrymmet per socket som är reserverat för sändningar. Detta beror inte på den maximala meddelandestorleken eller storleken på ett TCP-fönster. |
| ReceiveBuffer | 4098 | Anger det totala buffertutrymmet per socket som reserverats för mottagningar. Detta beror inte på den maximala meddelandestorleken eller storleken på ett TCP-fönster. |
| SendLowWater | 4099 | Anger lågvattenmärket för Send åtgärder. |
| ReceiveLowWater | 4100 | Anger lågvattenmärket för Receive åtgärder. |
| SendTimeout | 4101 | Skicka en timeout. Det här alternativet gäller endast synkrona metoder. det har ingen effekt på asynkrona metoder som BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) metoden. |
| ReceiveTimeout | 4102 | Få en timeout. Det här alternativet gäller endast synkrona metoder. det har ingen effekt på asynkrona metoder som BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) metoden. |
| Error | 4103 | Hämtar felstatusen och rensar. |
| Type | 4104 | Hämtar sockettypen. |
| ReuseUnicastPort | 12295 | Anger att systemet ska skjuta upp tillfällig portallokering för utgående anslutningar. Detta motsvarar att använda alternativet Winsock2 SO_REUSE_UNICASTPORT socket. |
| UpdateAcceptContext | 28683 | Uppdaterar egenskaperna för en godkänd socket med hjälp av egenskaperna för en befintlig socket. Detta motsvarar att använda alternativet Winsock2 SO_UPDATE_ACCEPT_CONTEXT socket och stöds endast på anslutningsorienterade socketar. |
| UpdateConnectContext | 28688 | Uppdaterar egenskaperna för en ansluten socket med hjälp av egenskaperna för en befintlig socket. Detta motsvarar att använda alternativet Winsock2 SO_UPDATE_CONNECT_CONTEXT socket och stöds endast på anslutningsorienterade socketar. |
| MaxConnections | 2147483647 | Stöds inte; genererar en SocketException om den används. |
Exempel
I följande kodexempel används den här uppräkningen för att ange socketalternativ.
// 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)
Kommentarer
Uppräkningen SocketOptionName definierar namnet på varje Socket konfigurationsalternativ. Sockets kan konfigureras med Socket.SetSocketOption metoden .