SocketOptionName Výčet
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Definuje názvy možností konfigurace.
public enum class SocketOptionName
public enum SocketOptionName
type SocketOptionName =
Public Enum SocketOptionName
- Dědičnost
Pole
AcceptConnection | 2 | Soket naslouchá. |
AddMembership | 12 | Přidejte členství ve skupině IP adres. |
AddSourceMembership | 15 | Připojte se ke zdrojové skupině. |
BlockSource | 17 | Zablokujte data ze zdroje. |
Broadcast | 32 | Povolte odesílání zpráv vysílání na soketu. |
BsdUrgent | 2 | Používejte urgentní data definovaná v dokumentu RFC-1222. Tuto možnost lze nastavit pouze jednou; po nastavení není možné ho vypnout. |
ChecksumCoverage | 20 | Nastavte nebo získejte pokrytí kontrolního součtu UDP. |
Debug | 1 | Zaznamenává informace o ladění. |
DontFragment | 14 | Ne fragmentujte datagramy PROTOKOLU IP. |
DontLinger | -129 | Zavřete sokety elegantně, aniž byste zůstali. |
DontRoute | 16 | Nesměrujte; odešle paket přímo na adresy rozhraní. |
DropMembership | 13 | Zahoďte členství ve skupině IP adres. |
DropSourceMembership | 16 | Vyhoďte zdrojovou skupinu. |
Error | 4103 | Získá stav chyby a vymaže se. |
ExclusiveAddressUse | -5 | Umožňuje, aby soket byl vázán pro výhradní přístup. |
Expedited | 2 | Používejte urychliná data definovaná v dokumentu RFC-1222. Tuto možnost lze nastavit pouze jednou; po nastavení není možné ho vypnout. |
HeaderIncluded | 2 | Označuje, že aplikace poskytuje hlavičku PROTOKOLU IP pro odchozí datagramy. |
HopLimit | 21 | Určuje maximální počet směrování směrovačů pro paket IPv6 (Internet Protocol verze 6). To se podobá hodnotě Time to Live (TTL) pro protokol Internet Protocol verze 4. |
IPOptions | 1 | Určuje možnosti PROTOKOLU IP, které se mají vkládat do odchozích datovýchgramů. |
IPProtectionLevel | 23 | Umožňuje omezení soketu IPv6 na zadaný obor, například adresy se stejnou místní předponou odkazu nebo místní předponou webu. Tato možnost soketu umožňuje aplikacím umístit omezení přístupu na sokety IPv6. Taková omezení umožňují aplikaci běžící na privátní síti LAN jednoduše a robustně posílit proti externím útokům. Tato možnost soketu rozšiřuje nebo zužuje rozsah naslouchacího soketu, umožňuje neomezený přístup od veřejných a soukromých uživatelů, pokud je to vhodné, nebo omezuje přístup pouze na stejný web podle potřeby. Tato možnost soketu definovala úrovně ochrany zadané v výčtu IPProtectionLevel . |
IpTimeToLive | 4 | Nastavte pole s záhlavím IP adres Time-to-Live. |
IPv6Only | 27 | Označuje, jestli je soket vytvořený pro rodinu adres AF_INET6 omezen pouze na komunikaci IPv6. Sokety vytvořené pro AF_INET6 řadu adres se můžou používat pro komunikaci IPv6 i IPv4. Některé aplikace můžou chtít omezit použití soketu vytvořeného pro AF_INET6 řadu adres pouze na komunikaci IPv6. Pokud je tato hodnota nenulová (výchozí hodnota v Windows), je možné použít soket vytvořený pro řadu AF_INET6 adres pouze k odesílání a přijímání paketů IPv6. Pokud je tato hodnota nula, lze soket vytvořený pro řadu adres AF_INET6 použít k odesílání a přijímání paketů do a z adresy IPv6 nebo adresy IPv4. Všimněte si, že možnost interakce s adresou IPv4 vyžaduje použití mapovaných adres IPv4. Tato možnost soketu je podporována v Windows Vista nebo novější. |
KeepAlive | 8 | Používejte udržování naživu. |
Linger | 128 | Pokud jsou nesentní data přítomna, můžete zůstat při zavření. |
MaxConnections | 2147483647 | Nepodporuje se; vyhodí, SocketException pokud se použije. |
MulticastInterface | 9 | Nastavte rozhraní pro odchozí pakety vícesměrového vysílání. |
MulticastLoopback | 11 | Zpětná smyčka vícesměrového vysílání IP. |
MulticastTimeToLive | 10 | Doba vícesměrového vysílání IP do živého vysílání. |
NoChecksum | 1 | Odesílání datovýchgramů UDP s kontrolním součtem nastaveným na nulu |
NoDelay | 1 | Zakáže algoritmus Nagle pro odesílání slučování. |
OutOfBandInline | 256 | Přijímá mimo pásmová data v normálním datovém proudu. |
PacketInformation | 19 | Vrátí informace o přijatých paketech. |
ReceiveBuffer | 4098 | Určuje celkový prostor vyrovnávací paměti pro jednotlivé sokety vyhrazený pro příjem. To nesouvisí s maximální velikostí zprávy nebo velikostí okna TCP. |
ReceiveLowWater | 4100 | Určuje nízkou vodní značku pro Receive operace. |
ReceiveTimeout | 4102 | Získejte časový limit. Tato možnost se vztahuje pouze na synchronní metody; nemá žádný vliv na asynchronní metody, jako BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) je metoda. |
ReuseAddress | 4 | Umožňuje, aby soket byl vázán na adresu, která se už používá. |
ReuseUnicastPort | 12295 | Označuje, že systém by měl odložit dočasné přidělení portů pro odchozí připojení. To je ekvivalentem použití možnosti SO_REUSE_UNICASTPORT soketu Winsock2. |
SendBuffer | 4097 | Určuje celkový prostor vyrovnávací paměti pro jednotlivé sokety vyhrazený pro odesílání. To nesouvisí s maximální velikostí zprávy nebo velikostí okna TCP. |
SendLowWater | 4099 | Určuje nízkou vodní značku pro Send operace. |
SendTimeout | 4101 | Odeslání časového limitu Tato možnost se vztahuje pouze na synchronní metody; nemá žádný vliv na asynchronní metody, jako BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) je metoda. |
TcpKeepAliveInterval | 17 | Počet sekund, po které bude připojení TCP čekat na zachování odezvy před odesláním další sondy keepalive. |
TcpKeepAliveRetryCount | 16 | Počet sond protokolu TCP, které budou odeslány před ukončením připojení. |
TcpKeepAliveTime | 3 | Počet sekund, po které připojení TCP zůstane aktivní nebo nečinný, než se do vzdáleného zařízení odešlou sondy zachování. |
Type | 4104 | Získá typ soketu. |
TypeOfService | 3 | Změňte typ hlavičky IP pole služby. |
UnblockSource | 18 | Odblokujte dříve blokovaný zdroj. |
UpdateAcceptContext | 28683 | Aktualizuje vlastnosti přijatého soketu pomocí existujících soketů. To je ekvivalentem použití možnosti SO_UPDATE_ACCEPT_CONTEXT soketu Winsock2 a podporuje se pouze u soketů orientovaných na připojení. |
UpdateConnectContext | 28688 | Aktualizuje vlastnosti připojeného soketu pomocí existujících soketů. To je ekvivalentem použití možnosti SO_UPDATE_CONNECT_CONTEXT soketu Winsock2 a podporuje se pouze u soketů orientovaných na připojení. |
UseLoopback | 64 | Pokud je to možné, vynecháte hardware. |
Příklady
Následující příklad kódu používá tento výčet k nastavení možností soketu.
// Specifies that send operations will time-out
// if confirmation is not received within 1000 milliseconds.
s->SetSocketOption( SocketOptionLevel::Socket, SocketOptionName::SendTimeout, 1000 );
// 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 );
// Send operations will time-out if confirmation
// is not received within 1000 milliseconds.
s.SetSocketOption (SocketOptionLevel.Socket, SocketOptionName.SendTimeout, 1000);
// The socket will linger for 10 seconds after Socket.Close is called.
LingerOption lingerOption = new LingerOption (true, 10);
s.SetSocketOption (SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption);
'Send operations will time-out if confirmation is
' not received within 1000 milliseconds.
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.SendTimeout, 1000)
' 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)
Poznámky
Výčet SocketOptionName definuje název každé Socket možnosti konfigurace. Sokety lze nakonfigurovat pomocí Socket.SetSocketOption metody.