SocketOptionName Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert die Konfigurationsoptionsnamen.
public enum class SocketOptionName
public enum SocketOptionName
type SocketOptionName =
Public Enum SocketOptionName
- Vererbung
Felder
AcceptConnection | 2 | Der Socket überwacht. |
AddMembership | 12 | Fügt eine IP-Gruppenmitgliedschaft hinzu. |
AddSourceMembership | 15 | Verknüpft eine Quellgruppe. |
BlockSource | 17 | Blockiert Daten aus einer Quelle. |
Broadcast | 32 | Lässt das Senden von Broadcastmeldungen für den Socket zu. |
BsdUrgent | 2 | Verwendet dringende Daten wie in RFC-1222 definiert. Diese Option kann nur einmal festgelegt werden. Nachdem sie festgelegt wurde, kann sie nicht deaktiviert werden. |
ChecksumCoverage | 20 | Legt die UDP-Prüfsummenabdeckung fest oder ruft diese ab. |
Debug | 1 | Zeichnet Debuginformationen auf. |
DontFragment | 14 | IP-Datagramme werden nicht fragmentiert. |
DontLinger | -129 | Schließt den Socket ordnungsgemäß und unverzüglich. |
DontRoute | 16 | Keine Weiterleitung. Das Paket wird direkt an die Schnittstellenadressen gesendet. |
DropMembership | 13 | Löscht eine IP-Gruppenmitgliedschaft. |
DropSourceMembership | 16 | Löscht eine Quellgruppe. |
Error | 4103 | Ruft den Fehlerstatus ab und löscht ihn. |
ExclusiveAddressUse | -5 | Ermöglicht das Binden eines Sockets für den exklusiven Zugriff. |
Expedited | 2 | Verwendet beschleunigte Daten wie in RFC-1222 definiert. Diese Option kann nur einmal festgelegt werden. Nachdem sie festgelegt wurde, kann sie nicht deaktiviert werden. |
HeaderIncluded | 2 | Gibt an, dass die Anwendung den IP-Header für ausgehende Datagramme bereitstellt. |
HopLimit | 21 | Gibt die maximale Anzahl von Routerweiterleitungen für ein IPv6 (Internet Protocol, Version 6)-Paket an. Dies entspricht der Gültigkeitsdauer (TTL) für Internet Protocol, Version 4. |
IPOptions | 1 | Gibt die IP-Optionen an, die in ausgehende Datagramme eingefügt werden sollen. |
IPProtectionLevel | 23 | Ermöglicht die Einschränkung eines IPv6-Sockets auf einen angegebenen Bereich, z. B. Adressen mit demselben lokalen Link- oder Standortpräfix. Mit dieser Socketoption können Anwendungen Zugriffsbeschränkungen für IPv6-Sockets festlegen. Mit solchen Einschränkungen kann sich eine im privaten LAN ausgeführte Anwendung selbst einfach und stabil vor externen Angriffen schützen. Diese Socketoption erweitert oder beschränkt den Bereich eines empfangsbereiten Sockets und ermöglicht so bei Bedarf den uneingeschränkten Zugriff von öffentlichen und privaten Benutzern oder beschränkt den Zugriff nur auf denselben Standort. Für diese Socketoption sind in der IPProtectionLevel-Enumeration angegebene Schutzebenen definiert. |
IpTimeToLive | 4 | Legt das Time-To-Live-Feld für die Gültigkeitsdauer im IP-Header fest. |
IPv6Only | 27 | Gibt an, ob ein für die AF_INET6-Adressfamilie erstellter Socket auf IPv6-Kommunikation beschränkt ist. Für die AF_INET6-Adressfamilie erstellte Sockets können sowohl für IPv6- als auch für IPv4-Kommunikation verwendet werden. In einigen Anwendungen kann es erforderlich sein, die Verwendung eines für die AF_INET6-Adressfamilie erstellten Sockets auf die IPv6-Kommunikation zu beschränken. Wenn dieser Wert ungleich 0 ist (Standardwert unter Windows), kann ein für die AF_INET6-Adressfamilie erstellter Socket verwendet werden, um nur IPv6-Pakete zu senden und zu empfangen. Wenn dieser Wert 0 ist, kann ein für die AF_INET6-Adressfamilie erstellter Socket zum Senden und Empfangen von IPv6- oder IPv4-Paketen verwendet werden. Die Möglichkeit der Interaktion mit einer IPv4-Adresse setzt die Verwendung von IPv4-zugeordneten Adressen voraus. Diese Socketoption wird unter Windows Vista oder höher unterstützt. |
KeepAlive | 8 | Verwendet Keep-Alives. |
Linger | 128 | Das Schließen wird verzögert, wenn nicht gesendete Daten vorhanden sind. |
MaxConnections | 2147483647 | Wird nicht unterstützt. Löst bei Verwendung eine SocketException aus. |
MulticastInterface | 9 | Legt die Schnittstelle für ausgehende Multicastpakete fest. |
MulticastLoopback | 11 | Ein IP-Multicast-Loopback. |
MulticastTimeToLive | 10 | Eine IP-Multicast-Gültigkeitsdauer. |
NoChecksum | 1 | Sendet UDP-Datagramme mit auf 0 festgelegter Prüfsumme. |
NoDelay | 1 | Deaktiviert den Nagle-Algorithmus für Sammelsendungen. |
OutOfBandInline | 256 | Empfängt Out-Of-Band-Daten im normalen Datenstream. |
PacketInformation | 19 | Gibt Informationen über empfangene Pakete zurück. |
ReceiveBuffer | 4098 | Gibt den Gesamtpufferspeicher pro Socket an, der für Empfangsvorgänge reserviert ist. Dies hängt nicht von der maximalen Meldungsgröße oder der Größe eines TCP-Fensters ab. |
ReceiveLowWater | 4100 | Gibt die untere Grenze für Receive-Vorgänge an. |
ReceiveTimeout | 4102 | Erhalten Sie ein Timeout. Diese Option gilt nur für synchrone Methoden. Es hat keine Auswirkungen auf asynchrone Methoden wie die BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) -Methode. |
ReuseAddress | 4 | Ermöglicht, dass der Socket an eine bereits verwendete Adresse gebunden wird. |
ReuseUnicastPort | 12295 | Gibt an, dass das System die Portzuordnung für ausgehende Verbindungen verzögern soll. Dies entspricht der Verwendung der SO_REUSE_UNICASTPORT-Socketoption von Winsock 2. |
SendBuffer | 4097 | Gibt den Gesamtpufferspeicher pro Socket an, der für Sendevorgänge reserviert ist. Dies hängt nicht von der maximalen Meldungsgröße oder der Größe eines TCP-Fensters ab. |
SendLowWater | 4099 | Gibt die untere Grenze für Send-Vorgänge an. |
SendTimeout | 4101 | Senden sie ein Timeout. Diese Option gilt nur für synchrone Methoden. Es hat keine Auswirkungen auf asynchrone Methoden wie die BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) -Methode. |
TcpKeepAliveInterval | 17 | Die Anzahl der Sekunden, die eine TCP-Verbindung auf eine Keep-Alive-Antwort wartet, bevor ein weiterer Keep-Alive-Test gesendet wird. |
TcpKeepAliveRetryCount | 16 | Die Anzahl der TCP-Keep-Alive-Tests, die vor dem Beenden der Verbindung gesendet werden. |
TcpKeepAliveTime | 3 | Die Anzahl der Sekunden, die eine TCP-Verbindung aktiv/im Leerlauf bleibt, bevor Keep-Alive-Tests an den Remotecomputer gesendet werden. |
Type | 4104 | Ruft den Sockettyp ab. |
TypeOfService | 3 | Ändert den Dienstfeldtyp des IP-Headers. |
UnblockSource | 18 | Hebt die Sperre einer zuvor blockierten Quelle auf. |
UpdateAcceptContext | 28683 | Aktualisiert die Eigenschaften eines angenommenen Sockets mit den Eigenschaften eines vorhandenen Sockets. Dies entspricht der Verwendung der SO_UPDATE_ACCEPT_CONTEXT-Socketoption von Winsock 2 und wird nur für verbindungsorientierte Sockets unterstützt. |
UpdateConnectContext | 28688 | Aktualisiert die Eigenschaften eines verbundenen Sockets mit den Eigenschaften eines vorhandenen Sockets. Dies entspricht der Verwendung der SO_UPDATE_CONNECT_CONTEXT-Socketoption von Winsock 2 und wird nur für verbindungsorientierte Sockets unterstützt. |
UseLoopback | 64 | Umgeht die Hardware nach Möglichkeit. |
Beispiele
Im folgenden Codebeispiel wird diese Enumeration verwendet, um Socketoptionen festzulegen.
// 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)
Hinweise
Die SocketOptionName -Enumeration definiert den Namen jeder Socket Konfigurationsoption. Sockets können mit der Socket.SetSocketOption -Methode konfiguriert werden.
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für