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 SocketOptionNamepublic enum SocketOptionNametype 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 všesměrového vysílání na soketu. |
| BsdUrgent | 2 | Používejte urgentní data definovaná v dokumentu RFC-1222. Tuto možnost lze nastavit pouze jednou; poté, co je nastaven, nelze ji vypnout. |
| ChecksumCoverage | 20 | Nastavte nebo získejte pokrytí kontrolního součtu UDP. |
| Debug | 1 | Zaznamenává informace o ladění. |
| DontFragment | 14 | Nestřílejte datagramy IP adres. |
| DontLinger | -129 | Zavřete soket elegantně, aniž byste museli přetrvávat. |
| DontRoute | 16 | Nesměrujte; odešle paket přímo na adresy rozhraní. |
| DropMembership | 13 | Zahoďte členství ve skupině IP adres. |
| DropSourceMembership | 16 | Odstraňte zdrojovou skupinu. |
| Error | 4103 | Získá stav chyby a vymaže se. |
| ExclusiveAddressUse | -5 | Umožňuje svázat soket pro výhradní přístup. |
| Expedited | 2 | Použijte urychlená data definovaná v dokumentu RFC-1222. Tuto možnost lze nastavit pouze jednou; poté, co je nastaven, nelze ji vypnout. |
| FastOpen | 15 | Povolí funkci TCP Fast Open definovanou v dokumentu RFC-7413. Skutečné pozorované chování závisí na konfiguraci operačního systému a stavu mezipaměti souborů cookie TCP jádra. Povolení TFO může mít vliv na interoperabilitu a způsobit problémy s připojením. |
| 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). Podobá se hodnotě TTL (Time to Live) pro protokol INTERNET Protocol verze 4. |
| IPOptions | 1 | Určuje možnosti PROTOKOLU IP, které se mají vložit do odchozích datagramů. |
| IPProtectionLevel | 23 | Povolí 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 umisťovat omezení přístupu na sokety IPv6. Taková omezení umožňují aplikacím běžícím na privátní síti LAN jednoduše a robustně posílit zabezpečení proti externím útokům. Tato možnost soketu rozšiřuje nebo zužuje rozsah naslouchacího soketu, přičemž v případě potřeby umožňuje neomezený přístup od veřejných a soukromých uživatelů nebo omezuje přístup pouze na stejnou lokalitu, jak je potřeba. Tato možnost soketu má definované úrovně ochrany zadané v IPProtectionLevel výčtu. |
| IpTimeToLive | 4 | Nastavte pole Time-to-Live záhlaví IP adresy. |
| IPv6Only | 27 | Označuje, jestli je soket vytvořený pro řadu adres AF_INET6 omezen pouze na komunikaci IPv6. Sokety vytvořené pro řadu adres AF_INET6 mohou být použity pro komunikaci IPv6 i IPv4. Některé aplikace můžou chtít omezit použití soketu vytvořeného pro řadu adres AF_INET6 pouze na komunikaci SPv6. Pokud je tato hodnota nenulová (výchozí hodnota ve Windows), lze k odesílání a přijímání paketů IPv6 použít soket vytvořený pro řadu AF_INET6 adres. Pokud je tato hodnota nula, je možné použít soket vytvořený pro řadu AF_INET6 adres k odesílání a přijímání paketů do a z adresy IPv6 nebo IPv4. Mějte na paměti, že schopnost pracovat s adresou IPv4 vyžaduje použití mapovaných adres IPv4. Tato možnost soketu je podporována v systému Windows Vista nebo novějším. |
| KeepAlive | 8 | Používejte udržování naživu. |
| Linger | 128 | Při zavření se zavírejte, pokud jsou přítomna neodeznaná data. |
| MaxConnections | 2147483647 | Nepodporováno; vyvolá 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 |
| NoChecksum | 1 | Odešlete datagramy UDP s kontrolním součtem nastaveným na nulu. |
| NoDelay | 1 | Zakáže algoritmus Nagle pro slučování odesílá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 s velikostí okna PROTOKOLU TCP. |
| ReceiveLowWater | 4100 | Určuje dolní mez pro Receive operace. |
| ReceiveTimeout | 4102 | Dostanete časový limit. Tato možnost se vztahuje pouze na synchronní metody; nemá žádný vliv na asynchronní metody, jako je BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) metoda. |
| ReuseAddress | 4 | Umožňuje, aby soket byl svázán s adresou, 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 odpovídá použití 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 s velikostí okna PROTOKOLU TCP. |
| SendLowWater | 4099 | Určuje dolní mez 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 je BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) metoda. |
| TcpKeepAliveInterval | 17 | Počet sekund, po které bude připojení TCP čekat na zachování odpovědi 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 úložiště odešlou sondy keepalive. |
| 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í těch z existujícího soketu. To je ekvivalentem použití SO_UPDATE_ACCEPT_CONTEXT rozhraní Winsock2 soketu a je podporován pouze u soketů orientovaných na připojení. |
| UpdateConnectContext | 28688 | Aktualizuje vlastnosti připojeného soketu pomocí těch z existujícího soketu. To je ekvivalentem použití možnosti SO_UPDATE_CONNECT_CONTEXT soketu Winsock2 a je podporován pouze u soketů orientovaných na připojení. |
| UseLoopback | 64 | Pokud je to možné, obejití hardwaru. |
Příklady
Následující příklad kódu používá tento výčet k nastavení možností soketu.
// 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)
Poznámky
Výčet SocketOptionName definuje název každé možnosti konfigurace Socket. Sokety lze nakonfigurovat pomocí metody Socket.SetSocketOption.
