SOL_SOCKET Socketoptionen
In den folgenden Tabellen werden SOL_SOCKET Socketoptionen beschrieben. Weitere Informationen zum Abrufen und Festlegen von Socketoptionen finden Sie auf den Referenzseiten der Funktionen getsockopt und setsockopt .
Um Protokolle aufzulisten und unterstützte Eigenschaften für jedes installierte Protokoll zu ermitteln, verwenden Sie die Funktion WSAEnumProtocols, WSCEnumProtocols oder WSCEnumProtocols32 .
Einige Socketoptionen erfordern mehr Erklärungen, als diese Tabellen vermitteln können. solche Optionen enthalten Links zu zusätzlichen Seiten.
Hinweis
Alle SOL_SOCKET Socketoptionen gelten gleichermaßen für IPv4 und IPv6 (mit Ausnahme von SO_BROADCAST, da Broadcast nicht in IPv6 implementiert ist).
SOL_SOCKET Socketoptionen
| Option | Herunterladen | Set | Optval-Typ | BESCHREIBUNG |
|---|---|---|---|---|
| PVD_CONFIG | ja | ja | char [] | Ein undurchsichtiges Datenstrukturobjekt, das Konfigurationsinformationen für den Dienstanbieter enthält. Diese Option ist von der Implementierung abhängig. |
| SO_ACCEPTCONN | ja | DWORD (boolescher Wert) | Gibt zurück, ob sich ein Socket im Lauschmodus befindet. Diese Option ist nur für verbindungsorientierte Protokolle gültig. | |
| SO_BROADCAST | ja | ja | DWORD (boolescher Wert) | Konfigurieren Sie einen Socket zum Senden von Broadcastdaten. Diese Option ist nur für Protokolle gültig, die Übertragung unterstützen (z. B. IPX und UDP). |
| SO_BSP_STATE | ja | CSADDR_INFO | Gibt die lokale Adresse, den lokalen Port, die Remoteadresse, den Remoteport, den Sockettyp und das Protokoll zurück, die von einem Socket verwendet werden. Weitere Informationen finden Sie in der Referenz zu SO_BSP_STATE . | |
| SO_CONDITIONAL_ACCEPT | ja | ja | DWORD (boolescher Wert) | Gibt an, ob eingehende Verbindungen von der Anwendung und nicht vom Protokollstapel akzeptiert oder abgelehnt werden sollen. Weitere Informationen finden Sie in der Referenz zu SO_CONDITIONAL_ACCEPT . |
| SO_CONNDATA | ja | ja | char [] | Zusätzliche Daten, nicht im normalen Netzwerkdatenstrom, die mit Netzwerkanforderungen gesendet werden, um eine Verbindung herzustellen. Diese Option wird von Legacyprotokollen wie DECNet, OSI TP4 und anderen verwendet. Diese Option wird vom TCP/IP-Protokoll in Windows nicht unterstützt. |
| SO_CONNDATALEN | ja | DWORD | Die Länge zusätzlicher Daten in Bytes, nicht im normalen Netzwerkdatenstrom, der mit Netzwerkanforderungen gesendet wird, um eine Verbindung herzustellen. Diese Option wird von Legacyprotokollen wie DECNet, OSI TP4 und anderen verwendet. Diese Option wird vom TCP/IP-Protokoll in Windows nicht unterstützt. | |
| SO_CONNECT_TIME | ja | DWORD | Gibt die Anzahl der Sekunden zurück, die ein Socket verbunden wurde. Diese Option ist nur für verbindungsorientierte Protokolle gültig. | |
| SO_CONNOPT | ja | ja | char [] | Zusätzliche Verbindungsoptionsdaten( nicht im normalen Netzwerkdatenstrom), die mit Netzwerkanforderungen gesendet werden, um eine Verbindung herzustellen. Diese Option wird von Legacyprotokollen wie DECNet, OSI TP4 und anderen verwendet. Diese Option wird vom TCP/IP-Protokoll in Windows nicht unterstützt. |
| SO_CONNOPTLEN | ja | DWORD | Die Länge der Verbindungsoptionsdaten in Bytes, nicht im normalen Netzwerkdatenstrom, der mit Netzwerkanforderungen zum Herstellen einer Verbindung gesendet wird. Diese Option wird von Legacyprotokollen wie DECNet, OSI TP4 und anderen verwendet. Diese Option wird vom TCP/IP-Protokoll in Windows nicht unterstützt. | |
| SO_DISCDATA | ja | ja | char [] | Zusätzliche Daten, nicht im normalen Netzwerkdatenstrom, die mit Netzwerkanforderungen gesendet werden, um eine Verbindung zu trennen. Diese Option wird von Legacyprotokollen wie DECNet, OSI TP4 und anderen verwendet. Diese Option wird vom TCP/IP-Protokoll in Windows nicht unterstützt. |
| SO_DISCDATALEN | ja | DWORD | Die Länge zusätzlicher Daten in Bytes, die nicht im normalen Netzwerkdatenstrom enthalten sind, der mit Netzwerkanforderungen gesendet wird, um eine Verbindung zu trennen. Diese Option wird von Legacyprotokollen wie DECNet, OSI TP4 und anderen verwendet. Diese Option wird vom TCP/IP-Protokoll in Windows nicht unterstützt. | |
| SO_DISCOPT | ja | ja | char [] | Zusätzliche Daten zum Trennen der Verbindung( nicht im normalen Netzwerkdatenstrom), die mit Netzwerkanforderungen gesendet werden, um eine Verbindung zu trennen. Diese Option wird von Legacyprotokollen wie DECNet, OSI TP4 und anderen verwendet. Diese Option wird vom TCP/IP-Protokoll in Windows nicht unterstützt. |
| SO_DISCOPTLEN | ja | DWORD | Die Länge der zusätzlichen Verbindungsoptionsdaten in Byte und nicht im normalen Netzwerkdatenstrom, der mit Netzwerkanforderungen gesendet wird, um eine Verbindung zu trennen. Diese Option wird von Legacyprotokollen wie DECNet, OSI TP4 und anderen verwendet. Diese Option wird vom TCP/IP-Protokoll in Windows nicht unterstützt. | |
| SO_DEBUG | ja | ja | DWORD (boolesch) | Aktivieren Sie die Debugausgabe. Microsoft-Anbieter geben derzeit keine Debuginformationen aus. |
| SO_DONTLINGER | ja | ja | DWORD (boolesch) | Gibt den Zustand des l_onoff Members der einem Socket zugeordneten Nachbaustruktur an. Wenn dieser Member nichtzero ist, bleibt ein Socket nach einem Aufruf der Closesocket-Funktion für eine bestimmte Zeit geöffnet, um das Senden von Daten in der Warteschlange zu ermöglichen. Diese Option gilt nur für zuverlässige, verbindungsorientierte Protokolle. |
| SO_DONTROUTE | ja | ja | DWORD (boolesch) | Gibt an, dass ausgehende Daten an eine Beliebige Schnittstelle gesendet werden sollen, an die der Socket gebunden ist, und nicht an einer anderen Schnittstelle. Diese Option ist nur gültig für nachrichtenorientierte Protokolle. Microsoft-Anbieter ignorieren diese Option im Hintergrund und konsultieren immer die Routingtabelle, um die entsprechende ausgehende Schnittstelle zu finden. |
| SO_ERROR | ja | DWORD | Gibt den letzten Fehlercode für diesen Socket zurück. Dieser Fehlercode pro Socket wird nicht immer sofort festgelegt. | |
| SO_EXCLUSIVEADDRUSE | ja | ja | DWORD (boolesch) | Verhindert, dass ein anderer Socket an dieselbe Adresse und denselben Port gebunden wird. Diese Option muss vor dem Aufrufen der Bindungsfunktion festgelegt werden. Weitere Informationen finden Sie in der referenz SO_EXCLUSIVEADDRUSE . |
| SO_GROUP_ID | ja | unsigned int | Diese Socketoption ist reserviert und sollte nicht verwendet werden. | |
| SO_GROUP_PRIORITY | ja | ja | INT | Diese Socketoption ist reserviert und sollte nicht verwendet werden. |
| SO_KEEPALIVE | ja | ja | DWORD (boolesch) | Aktiviert Keep-Alive für eine Socketverbindung. Gilt nur für Protokolle, die den Begriff keep-alive (verbindungsorientierte Protokolle) unterstützen. Bei TCP beträgt das standardmäßige Keep-Alive-Timeout 2 Stunden und das Keep-Alive-Intervall eine Sekunde. Die Standardanzahl von Keep-Alive-Tests variiert abhängig von der Windows-Version. Weitere Informationen finden Sie in der referenz SO_KEEPALIVE . |
| SO_LINGER | ja | ja | Struktur verharren | Gibt den Zustand der einem Socket zugeordneten Nachhaltenstruktur an. Wenn das l_onoff Member der linger-Struktur nonzero ist, bleibt ein Socket nach einem Aufruf der Closesocket-Funktion für eine bestimmte Zeit geöffnet, um das Senden von Daten in die Warteschlange zu ermöglichen. Die Dauer des Öffnens in Sekunden wird im l_linger Member der linger-Struktur angegeben. Diese Option gilt nur für zuverlässige, verbindungsorientierte Protokolle. |
| SO_MAX_MSG_SIZE | ja | DWORD | Gibt die maximale Größe ausgehender Nachrichten für nachrichtenorientierte Sockets zurück, die vom Protokoll unterstützt werden. Hat keine Bedeutung für streamorientierte Sockets. | |
| SO_MAXDG | ja | DWORD | Gibt die maximale Größe (in Bytes) für ausgehende Datagramme zurück, die vom Protokoll unterstützt werden. Diese Socketoption hat keine Bedeutung für streamorientierte Sockets. | |
| SO_MAXPATHDG | ja | DWORD | Gibt die maximale Größe (in Bytes) für ausgehende Datagramme zurück, die vom Protokoll an eine bestimmte Zieladresse unterstützt werden. Diese Socketoption hat keine Bedeutung für streamorientierte Sockets. Microsoft-Anbieter können dies als SO_MAXDG behandeln. | |
| SO_OOBINLINE | ja | ja | DWORD (boolesch) | Gibt an, dass out-of-bound-Daten inline mit regulären Daten zurückgegeben werden sollen. Diese Option gilt nur für verbindungsorientierte Protokolle, die Out-of-Band-Daten unterstützen. |
| SO_OPENTYPE | ja | ja | DWORD | Nach dem Festlegen wirkt sich darauf aus, ob nachfolgende Sockets, die erstellt werden, nicht überlappen. Die möglichen Werte für diese Option sind SO_SYNCHRONOUS_ALERT und SO_SYNCHRONOUS_NONALERT. Diese Option sollte nicht verwendet werden. Verwenden Sie stattdessen die WSASocket-Funktion , und lassen Sie das WSA_FLAG_OVERLAPPED Bit im dwFlags-Parameter deaktiviert. |
| SO_PAUSE_ACCEPT | ja | ja | DWORD(boolean) | Verwenden Sie diese Option zum Überwachen von Sockets. Wenn die Option festgelegt ist, reagiert der Socket auf alle eingehenden Verbindungen mit einer RST, anstatt sie zu akzeptieren. |
| SO_PORT_SCALABILITY | ja | ja | DWORD (boolesch) | Ermöglicht die Skalierbarkeit des lokalen Ports für einen Socket, indem die Portzuordnung durch mehrfaches Zuweisen von Platzhalterports für verschiedene lokale Adressportpaare auf einem lokalen Computer maximiert werden kann. Auf Plattformen, auf denen beide Optionen verfügbar sind, bevorzugen Sie SO_REUSE_UNICASTPORT anstelle dieser Option. Weitere Informationen finden Sie in der Referenz zu SO_PORT_SCALABILITY . |
| SO_PROTOCOL_INFO | ja | WSAPROTOCOL_INFO | Diese Option wird für die Socketoption SO_PROTOCOL_INFOW definiert, wenn das UNICODE-Makro definiert ist. Wenn das UNICODE-Makro nicht definiert ist, wird diese Option für die Socketoption SO_PROTOCOL_INFOA definiert. | |
| SO_PROTOCOL_INFOA | ja | WSAPROTOCOL_INFOA | Gibt die WSAPROTOCOL_INFOA-Struktur für den angegebenen Socket zurück. | |
| SO_PROTOCOL_INFOW | ja | WSAPROTOCOL_INFOW | Gibt die WSAPROTOCOL_INFOW-Struktur für den angegebenen Socket zurück. | |
| SO_RANDOMIZE_PORT | ja | ja | DWORD(boolescher Wert) | Diese Option sollte für einen ungebundenen Socket festgelegt werden. Wenn SO_RANDOMIZE_PORT festgelegt ist und ein kurzlebiger Port für den Socket ausgewählt wird, wird eine zufällige Portnummer gebunden. Die automatische Wiederverwendung von Ports (ports, die mit SO_REUSE_UNICASTPORT ausgewählt wurden) zufällig den zurückgegebenen Port. Wenn also eine Anwendung SO_REUSE_UNICASTPORT festlegt und dann versucht, SO_RANDOMIZE_PORT festzulegen, schlägt der zweite setockopt-Aufruf fehl. |
| SO_RCVBUF | ja | ja | DWORD | Der insgesamt reservierte Pufferspeicherplatz pro Socket für Empfänge. Dies steht in keinem Zusammenhang mit SO_MAX_MSG_SIZE und entspricht nicht unbedingt der Größe des TCP-Empfangsfensters. |
| SO_RCVLOWAT | ja | ja | DWORD | Eine Socketoption von BSD UNIX aus Gründen der Abwärtskompatibilität. Mit dieser Option wird die Mindestanzahl von Bytes festgelegt, die für Socketeingabevorgänge verarbeitet werden sollen. Diese Option wird vom Windows TCP/IP-Anbieter nicht unterstützt. Wenn diese Option unter Windows Vista und höher verwendet wird, schlagen die Funktionen getsockopt und setsockopt mit WSAEINVAL fehl. In früheren Versionen von Windows schlagen diese Funktionen mit WSAENOPROTOOPT fehl. |
| SO_RCVTIMEO | ja | ja | DWORD | Das Timeout in Millisekunden für das Blockieren von Empfangsanrufen. Der Standardwert für diese Option ist 0. Dies bedeutet, dass bei einem Empfangsvorgang kein Timeout auftritt. Wenn bei einem blockierenden Empfangsanruf ein Timeout auftritt, befindet sich die Verbindung in einem unbestimmten Zustand und sollte geschlossen werden. Wenn der Socket mit der WSASocket-Funktion erstellt wird, muss für den dwFlags-Parameter das attribut WSA_FLAG_OVERLAPPED festgelegt sein, damit das Timeout ordnungsgemäß funktioniert. Andernfalls wird das Timeout nie wirksam. |
| SO_REUSEADDR | ja | ja | DWORD (boolescher Wert) | Ermöglicht es einem Socket, eine Bindung an eine Adresse und einen Port zu binden, die bereits verwendet werden. Die Option SO_EXCLUSIVEADDRUSE kann dies verhindern. |
| SO_REUSE_UNICASTPORT | ja | ja | DWORD (boolescher Wert) | Wenn festgelegt, lassen Sie die Wiederverwendung kurzlebiger Ports für Winsock-API-Verbindungsfunktionen zu, die eine explizite Bindung erfordern, z. B. ConnectEx. Beachten Sie, dass für Verbindungsfunktionen mit impliziter Bindung (z. B. herstellen ohne explizite Bindung) diese Option standardmäßig festgelegt ist. Verwenden Sie diese Option anstelle von SO_PORT_SCALABILITY auf Plattformen, auf denen beide verfügbar sind. |
| SO_REUSE_MULTICASTPORT | ja | DWORD | Wenn sie für einen Socket festgelegt ist, gibt diese Option an, dass der Socket niemals zum Empfangen von Unicastpaketen verwendet wird und folglich sein Port für andere Nur-Multicastanwendungen freigegeben werden kann. Wenn Sie den Wert auf 1 festlegen, wird multicastdatenverkehr am Port immer gemeinsam verwendet. Wenn Sie den Wert auf 0 (Standard) festlegen, wird dieses Verhalten deaktiviert. | |
| SO_SNDBUF | ja | ja | DWORD | Der insgesamt reservierte Pufferspeicher pro Socket für Sendevorgänge. Dies steht in keinem Zusammenhang mit SO_MAX_MSG_SIZE und entspricht nicht unbedingt der Größe eines TCP-Sendefensters. |
| SO_SNDLOWAT | ja | ja | DWORD | Eine Socketoption von BSD UNIX aus Gründen der Abwärtskompatibilität. Mit dieser Option wird die Mindestanzahl von Bytes festgelegt, die für Socketausgabevorgänge verarbeitet werden sollen. Diese Option wird vom Windows TCP/IP-Anbieter nicht unterstützt. Wenn diese Option unter Windows Vista und höher verwendet wird, schlagen die Funktionen getsockopt und setsockopt mit WSAEINVAL fehl. In früheren Versionen von Windows schlagen diese Funktionen mit WSAENOPROTOOPT fehl. |
| SO_SNDTIMEO | ja | ja | DWORD | Das Timeout in Millisekunden für das Blockieren von Sendeanrufen. Der Standardwert für diese Option ist 0(0), was angibt, dass bei einem Sendevorgang kein Timeout auftritt. Wenn bei einem blockierenden Sendeanruf ein Timeout besteht, befindet sich die Verbindung in einem unbestimmten Zustand und sollte geschlossen werden. Wenn der Socket mit der WSASocket-Funktion erstellt wird, muss für den dwFlags-Parameter das attribut WSA_FLAG_OVERLAPPED festgelegt sein, damit das Timeout ordnungsgemäß funktioniert. Andernfalls wird das Timeout nie wirksam. |
| SO_TYPE | ja | DWORD | Gibt den Sockettyp für den angegebenen Socket zurück (z. B. SOCK_STREAM oder SOCK_DGRAM). | |
| SO_UPDATE_ACCEPT_CONTEXT | ja | DWORD (boolescher Wert) | Diese Option wird mit der AcceptEx-Funktion verwendet. Mit dieser Option werden die Eigenschaften des Sockets aktualisiert, die vom lauschenden Socket geerbt werden. Diese Option sollte festgelegt werden, wenn die Funktionen getpeername, getsockname, getsockopt oder setsockopt für den akzeptierten Socket verwendet werden sollen. | |
| SO_UPDATE_CONNECT_CONTEXT | ja | DWORD (boolescher Wert) | Diese Option wird mit den Funktionen ConnectEx, WSAConnectByList und WSAConnectByName verwendet. Mit dieser Option werden die Eigenschaften des Sockets aktualisiert, nachdem die Verbindung hergestellt wurde. Diese Option sollte festgelegt werden, wenn die Funktionen getpeername, getsockname, getsockopt, setsockopt oder shutdown für den verbundenen Socket verwendet werden sollen. | |
| SO_USELOOPBACK | ja | ja | DWORD (boolesch) | Verwenden Sie die lokale Loopbackadresse, wenn Sie Daten aus diesem Socket senden. Diese Option sollte nur verwendet werden, wenn alle gesendeten Daten auch lokal empfangen werden. Diese Option wird vom Windows TCP/IP-Anbieter nicht unterstützt. Wenn diese Option unter Windows Vista und höher verwendet wird, schlagen die Funktionen getockopt und setsockopt mit WSAEINVAL fehl. In früheren Versionen von Windows schlagen diese Funktionen mit WSAENOPROTOOPT fehl. |
Windows-Unterstützung für SOL_SOCKET-Optionen
| Option | Windows 10 | Windows 7 | Windows Server 2008 | Windows Vista | Windows Server 2003 | Windows XP | Windows 2000 | Windows NT4 | Windows 9x/ME |
|---|---|---|---|---|---|---|---|---|---|
| PVD_CONFIG | |||||||||
| SO_ACCEPTCONN | x | x | x | x | x | x | x | x | x |
| SO_BROADCAST | x | x | x | x | x | x | x | x | x |
| SO_BSP_STATE | x | x | x | x | |||||
| SO_CONDITIONAL_ACCEPT | x | x | x | x | x | x | x | ||
| SO_CONNDATA | x | x | x | x | x | x | x | x | |
| SO_CONNDATALEN | x | x | x | x | x | x | x | x | |
| SO_CONNECT_TIME | x | x | x | x | x | x | x | x | x |
| SO_CONNOPT | x | x | x | x | x | x | x | x | |
| SO_CONNOPTLEN | x | x | x | x | x | x | x | x | |
| SO_DISCDATA | x | x | x | x | x | x | x | x | |
| SO_DISCDATALEN | x | x | x | x | x | x | x | x | |
| SO_DISCOPT | x | x | x | x | x | x | x | x | |
| SO_DISCOPTLEN | x | x | x | x | x | x | x | x | |
| SO_DEBUG | x | x | x | x | x | x | x | x | x |
| SO_DONTLINGER | x | x | x | x | x | x | x | x | x |
| SO_DONTROUTE | x | x | x | x | x | x | x | x | x |
| SO_ERROR | x | x | x | x | x | x | x | x | x |
| SO_EXCLUSIVEADDRUSE | x | x | x | x | x | x | x | x SP4+ | |
| SO_GROUP_ID | x | x | x | x | |||||
| SO_GROUP_PRIORITY | x | x | x | x | |||||
| SO_KEEPALIVE | x | x | x | x | x | x | x | x | x |
| SO_LINGER | x | x | x | x | x | x | x | x | x |
| SO_MAX_MSG_SIZE | x | x | x | x | x | x | x | x | x |
| SO_MAXDG | x | x | x | x | x | x | x | ||
| SO_MAXPATHDG | x | x | x | x | x | x | x | ||
| SO_OOBINLINE | x | x | x | x | x | x | x | x | x |
| SO_OPENTYPE | x | x | x | x | x | x | x | x | x |
| SO_PORT_SCALABILITY | x | x | x | ||||||
| SO_PROTECT | x | ||||||||
| SO_PROTOCOL_INFO | x | x | x | x | x | x | x | x | x |
| SO_PROTOCOL_INFOA | x | x | x | x | x | x | x | x | x |
| SO_PROTOCOL_INFOW | x | x | x | x | x | x | x | x | x |
| SO_RCVBUF | x | x | x | x | x | x | x | x | x |
| SO_RCVLOWAT | |||||||||
| SO_RCVTIMEO | x | x | x | x | x | x | x | x | x |
| SO_RANDOMIZE_PORT | x | x | x | x | |||||
| SO_REUSEADDR | x | x | x | x | x | x | x | x | x |
| SO_REUSE_UNICASTPORT | x | ||||||||
| SO_REUSE_MULTICASTPORT | x | ||||||||
| SO_SNDBUF | x | x | x | x | x | x | x | x | x |
| SO_SNDLOWAT | |||||||||
| SO_SNDTIMEO | x | x | x | x | x | x | x | x | x |
| SO_TYPE | x | x | x | x | x | x | x | x | x |
| SO_UPDATE_ACCEPT_CONTEXT | x | x | x | x | x | x | x | x | |
| SO_UPDATE_CONNECT_CONTEXT | x | x | x | x | x | x | |||
| SO_USELOOPBACK |
Bemerkungen
Die SOL_SOCKET Socketoptionen sind in mehreren Winsock-Headerdateien definiert:
- Winsock2.h
- Mswsock.h
- Ws2def.h
Im Microsoft Windows Software Development Kit (SDK), das für Windows Vista und höher veröffentlicht wurde, wurde die organization von Headerdateien geändert, und SOL_SOCKET Ebene wird in der Ws2def.h-Headerdatei definiert, die automatisch in der Winsock2.h-Headerdatei enthalten ist. Einige der SOL_SOCKET Socketoptionen sind in den Headerdateien Winsock2.h und Mswsock.h definiert. Die verbleibenden SOL_SOCKET Socketoptionen sind in der Ws2def.h-Headerdatei definiert, die automatisch in der Winsock2.h-Headerdatei enthalten ist. Ws2def.h sollte niemals direkt verwendet werden.
Im Platform Software Development Kit (SDK), das für Windows Server 2003 und Windows XP veröffentlicht wurde, wird die SOL_SOCKET Ebene in der Winsock2.h-Headerdatei definiert. Die SOL_SOCKET Socketoptionen sind in den Headerdateien Winsock2.h und Mswsock.h definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|