_IPPROTO-UDP-Socketoptionen
In der folgenden Tabelle werden die IPPROTO-UDP-Socketoptionen _ beschrieben, die für Sockets gelten, die für die IPv4- und IPv6-Adressfamilien (AF INET und AF INET6) mit dem Protokollparameter für die als _ _ UDP (IPPROTO _ UDP) angegebene Socketfunktion erstellt wurden. Weitere Informationen zum Abrufen und Festlegen von Socketoptionen finden Sie auf den Referenzseiten der getsockopt- und setsockopt-Funktion.
Um Protokolle aufzählen und unterstützte Eigenschaften für jedes installierte Protokoll zu finden, verwenden Sie die WSAEnumProtocols-, WSCEnumProtocols-oder WSCEnumProtocols32-Funktion.
Optionen
| Option | Herunterladen | Set | Optval-Typ | BESCHREIBUNG |
|---|---|---|---|---|
| UDP _ CHECKSUM _ COVERAGE (ws2tcpip.h) | ja | ja | DWORD (boolean) | Bei TRUE werden UDP-Datagramme mit einer Prüfsumme gesendet. |
| UDP _ NOCHECKSUM (ws2tcpip.h) | ja | ja | DWORD (boolean) | Bei TRUE werden UDP-Datagramme mit der Prüfsumme 0 (null) gesendet. Erforderlich für Dienstanbieter. Wenn ein Dienstanbieter nicht über einen Mechanismus zum Deaktivieren der UDP-Prüfsummenberechnung verfügt, kann er diese Option einfach speichern, ohne Maßnahmen zu ergreifen. Diese Option wird für IPv6 nicht unterstützt. |
| UDP_RECV_MAX_COALESCED_SIZE (ws2ipdef.h; include ws2tcpip.h) | ja | ja | DWORD | Wenn sie auf einen Wert festgelegt ist, der nicht 0 (null) ist, können mehrere empfangene Datagramme zu einem einzelnen Nachrichtenpuffer zusammengeknaust werden, bevor sie für Ihre Anwendung angegeben werden. Der Optionswert stellt die maximale Nachrichtengröße in Bytes für zusammenfingierte Nachrichten dar, die für Ihre Anwendung angegeben werden können. Nicht zusammengeknauste Nachrichten, die größer als der Optionswert sind, werden möglicherweise weiterhin angezeigt. Der Standardwert ist 0 (kein Zusammenbau). Datagramme werden nur dann zusammenfingt, wenn sie von derselben Quelladresse und demselben Port stammen. Alle zusammenfingierten Datagramme haben die gleiche Größe, mit Ausnahme des letzten — Datagramms, das kleiner sein kann. Wenn Ihre Anwendung die zusammengefassten Datagrammgrößen abrufen möchte (mit Ausnahme des letzten Datagramms, das sich unterscheiden kann), müssen Sie eine Empfangs-API verwenden, die Steuerungsinformationen unterstützt (z. B. LPFN_WSARECVMSG (WSARecvMsg). Die Größe aller bis auf die letzte Nachricht finden Sie in der UDP_COALESCED_INFO-Steuermeldung vom Typ DWORD. Aus Sicherheitsgründen sollte Ihre Anwendung die Funktionen WSAGetUdpRecvMaxCoalescedSize und WSASetUdpRecvMaxCoalescedSize direkt anstelle der Socketoption verwenden. |
| UDP_SEND_MSG_SIZE (ws2ipdef.h; include ws2tcpip.h) | ja | ja | DWORD | Wenn sie auf einen Wert festgelegt ist, der nicht 0 (null) ist, werden die von Ihrer Anwendung gesendeten Puffer vom Netzwerkstapel in mehrere Nachrichten aufgeschlüsselt. Der Optionswert stellt die Größe der einzelnen aufgeschlüsselten Nachrichten dar. Der Optionswert wird in Bytes dargestellt. Die Größe des letzten Segments kann kleiner als der Wert der Option sein. Der Standardwert ist 0 (keine Segmentierung). Ihre Anwendung sollte einen Wert festlegen, der niedriger als die MTU des Pfads zu den Ziel(en) ist, um eine IP-Fragmentierung zu vermeiden. Aus Sicherheitsgründen sollte Ihre Anwendung die Funktionen WSAGetUdpSendMessageSize und WSASetUdpSendMessageSize direkt anstelle der Socketoption verwenden. |
Legacy Windows unterstützung für _ IPPROTO-UDP-Optionen
UDP _ CHECKSUM _ COVERAGE ist auf Windows 2000 und auf Windows NT4 nicht verfügbar. UDP _ CHECKSUM _ COVERAGE und UDP _ NOCHECKSUM sind auf Windows 9x/Me nicht verfügbar.
Bemerkungen
Auf dem Microsoft Windows Software Development Kit (SDK), das für Windows Vista und höher veröffentlicht wurde, hat sich die Organisation der Headerdateien geändert, und die _ IPPROTO-UDP-Ebene wird in der Ws2def.h-Headerdatei definiert, die automatisch in der Winsock2.h-Headerdatei enthalten ist. Die _ IPPROTO-UDP-Socketoptionen werden in der Headerdatei Ws2tcpip.h definiert. Die Ws2def.h-Headerdatei sollte nie direkt verwendet werden.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Header |
|