Delen via


IPPROTO_UDP socketopties

In de volgende tabel worden IPPROTO_UDP socketopties beschreven die van toepassing zijn op sockets die zijn gemaakt voor de IPv4- en IPv6-adresfamilies (AF_INET en AF_INET6) met de parameter protocol op de socket--functie die is opgegeven als UDP (IPPROTO_UDP). Zie de getsockopt en setsockopt functiereferentiepagina's voor meer informatie over het ophalen en instellen van socketopties.

Als u protocollen wilt inventariseren en ondersteunde eigenschappen voor elk geïnstalleerd protocol wilt detecteren, gebruikt u de WSAEnumProtocols, WSCEnumProtocolsof de functie WSCEnumProtocols32.

Opties

Optie Toevoegen Set Type optval Beschrijving
UDP_CHECKSUM_COVERAGE (ws2tcpip.h) ja ja DWORD (Booleaanse waarde) Wanneer TRUE, worden UDP-gegevensgrammen verzonden met een controlesom.
UDP_NOCHECKSUM (ws2tcpip.h) ja ja DWORD (Booleaanse waarde) Wanneer TRUE, worden UDP-gegevensgrammen verzonden met de controlesom van nul. Vereist voor serviceproviders. Als een serviceprovider geen mechanisme heeft om UDP-controlesomberekening uit te schakelen, kan deze optie gewoon worden opgeslagen zonder actie te ondernemen. Deze optie wordt niet ondersteund voor IPv6.
UDP_RECV_MAX_COALESCED_SIZE (ws2ipdef.h; include ws2tcpip.h) ja ja DWORD Wanneer deze waarde is ingesteld op een waarde die niet nul is, kunnen meerdere ontvangen gegevensgrammen worden samengevoegd tot één berichtbuffer voordat ze aan uw toepassing worden aangegeven. De optiewaarde vertegenwoordigt de maximale berichtgrootte in bytes voor gegroepeerde berichten die aan uw toepassing kunnen worden aangegeven. Niet-gekoppelde berichten die groter zijn dan de optiewaarde, kunnen nog steeds worden aangegeven. De standaardwaarde is 0 (geen samenvoegen). Datagrammen worden alleen samengevoegd als ze afkomstig zijn van hetzelfde bronadres en dezelfde poort. Alle datagrammen die zijn samengesamend, hebben dezelfde grootte, behalve het laatste datagram, dat mogelijk kleiner is. Als uw toepassing de gegevensgramgrootten wil ophalen (behalve het laatste datagram, dat kan verschillen) die zijn samengevoegd, moet u een ontvangst-API gebruiken die ondersteuning biedt voor besturingsinformatie (zoals LPFN_WSARECVMSG (WSARecvMsg)). De grootte van alle, maar het laatste bericht is te vinden in het UDP_COALESCED_INFO besturingselementbericht, van het type DWORD. Voor typeveiligheid moet uw toepassing gebruikmaken van de WSAGetUdpRecvMaxCoalescedSize en WSASetUdpRecvMaxCoalescedSize-functies in plaats van de socketoptie rechtstreeks.
UDP_SEND_MSG_SIZE (ws2ipdef.h; include ws2tcpip.h) ja ja DWORD Wanneer deze waarde is ingesteld op een waarde die niet nul is, worden buffers die door uw toepassing worden verzonden, opgesplitst in meerdere berichten door de netwerkstack. De optiewaarde vertegenwoordigt de grootte van elk uitgesplitst bericht. De optiewaarde wordt weergegeven in bytes. De grootte van het laatste segment kan kleiner zijn dan de waarde van de optie. De standaardwaarde is 0 (geen segmentatie). Uw toepassing moet een waarde instellen die lager is dan de MTU van het pad naar de bestemming(en) om IP-fragmentatie te voorkomen. Voor typeveiligheid moet uw toepassing de functies WSAGetUdpSendMessageSize en WSASetUdpSendMessageSize gebruiken in plaats van de socketoptie rechtstreeks.

Verouderde Windows-ondersteuning voor IPPROTO_UDP-opties

UDP_CHECKSUM_COVERAGE is niet beschikbaar in Windows 2000 en windows NT4. UDP_CHECKSUM_COVERAGE en UDP_NOCHECKSUM zijn niet beschikbaar in Windows 9x/Me.

Opmerkingen

In de Microsoft Windows Software Development Kit (SDK) die is uitgebracht voor Windows Vista en later, is de organisatie van headerbestanden gewijzigd en wordt IPPROTO_UDP niveau gedefinieerd in het headerbestand Ws2def.h dat automatisch wordt opgenomen in het Winsock2.h headerbestand. De IPPROTO_UDP socketopties worden gedefinieerd in het Ws2tcpip.h headerbestand. Het Ws2def.h headerbestand mag nooit rechtstreeks worden gebruikt.

Eisen

Eis Waarde
Rubriek
ws2ipdef.h (inclusief ws2tcpip.h) en ws2tcpip.h
Winsock2.h op Windows Server 2003, Windows XP en Windows 2000