SocketOptionName SocketOptionName SocketOptionName SocketOptionName Enum

Definizione

Definisce i nomi delle opzioni di configurazione.Defines configuration option names.

public enum class SocketOptionName
public enum SocketOptionName
type SocketOptionName = 
Public Enum SocketOptionName
Ereditarietà
SocketOptionNameSocketOptionNameSocketOptionNameSocketOptionName

Campi

AcceptConnection AcceptConnection AcceptConnection AcceptConnection 2

Il socket è in ascolto.The socket is listening.

AddMembership AddMembership AddMembership AddMembership 12

Aggiunge un'appartenenza a un gruppo IP.Add an IP group membership.

AddSourceMembership AddSourceMembership AddSourceMembership AddSourceMembership 15

Unisce a un gruppo di origine.Join a source group.

BlockSource BlockSource BlockSource BlockSource 17

Blocca i dati da un'origine.Block data from a source.

Broadcast Broadcast Broadcast Broadcast 32

Consente l'invio di messaggi trasmessi sul socket.Permit sending broadcast messages on the socket.

BsdUrgent BsdUrgent BsdUrgent BsdUrgent 2

Usa dati urgenti come definito in RFC-1222.Use urgent data as defined in RFC-1222. Questa opzione può essere impostata una sola volta. Dopo essere stata impostata, non può essere disattivata.This option can be set only once; after it is set, it cannot be turned off.

ChecksumCoverage ChecksumCoverage ChecksumCoverage ChecksumCoverage 20

Imposta o ottiene la copertura checksum UDP.Set or get the UDP checksum coverage.

Debug Debug Debug Debug 1

Registra informazioni di debug.Record debugging information.

DontFragment DontFragment DontFragment DontFragment 14

Non frammenta i datagrammi IP.Do not fragment IP datagrams.

DontLinger DontLinger DontLinger DontLinger -129

Chiude normalmente il socket senza tempo di ritardo.Close the socket gracefully without lingering.

DontRoute DontRoute DontRoute DontRoute 16

Non effettua il routing e invia il pacchetto direttamente agli indirizzi di interfaccia.Do not route; send the packet directly to the interface addresses.

DropMembership DropMembership DropMembership DropMembership 13

Rilasciare un'appartenenza a un gruppo IP.Drop an IP group membership.

DropSourceMembership DropSourceMembership DropSourceMembership DropSourceMembership 16

Rilascia un gruppo di origine.Drop a source group.

Error Error Error Error 4103

Ottiene ed elimina lo stato di errore.Gets the error status and clear.

ExclusiveAddressUse ExclusiveAddressUse ExclusiveAddressUse ExclusiveAddressUse -5

Abilita l'associazione di un socket per l'accesso esclusivo.Enables a socket to be bound for exclusive access.

Expedited Expedited Expedited Expedited 2

Usa dati accelerati come definito in RFC-1222.Use expedited data as defined in RFC-1222. Questa opzione può essere impostata una sola volta. Dopo essere stata impostata, non può essere disattivata.This option can be set only once; after it is set, it cannot be turned off.

HeaderIncluded HeaderIncluded HeaderIncluded HeaderIncluded 2

Indica che l'applicazione fornisce l'intestazione IP per i datagrammi in uscita.Indicates that the application provides the IP header for outgoing datagrams.

HopLimit HopLimit HopLimit HopLimit 21

Specifica il numero massimo di hop del router per un pacchetto IPv6.Specifies the maximum number of router hops for an Internet Protocol version 6 (IPv6) packet. È simile alla durata (TTL) per IPv4.This is similar to Time to Live (TTL) for Internet Protocol version 4.

IPOptions IPOptions IPOptions IPOptions 1

Specifica le opzioni IP da inserire nei datagrammi in uscita.Specifies the IP options to be inserted into outgoing datagrams.

IPProtectionLevel IPProtectionLevel IPProtectionLevel IPProtectionLevel 23

Abilita la restrizione di un socket IPv6 a un ambito specificato, ad esempio indirizzi con lo stesso prefisso locale rispetto al collegamento o al sito. Questa opzione socket consente alle applicazioni di inserire restrizioni di accesso sui socket IPv6.Enables restriction of a IPv6 socket to a specified scope, such as addresses with the same link local or site local prefix.This socket option enables applications to place access restrictions on IPv6 sockets. Tali restrizioni consentono a un'applicazione in esecuzione su una LAN privata di proteggersi in modo semplice e affidabile da attacchi esterni.Such restrictions enable an application running on a private LAN to simply and robustly harden itself against external attacks. Questa opzione socket allarga o restringe l'ambito di un socket in attesa, consentendo l'accesso illimitato di utenti pubblici e privati, laddove appropriato, o limitando l'accesso solo al medesimo sito, secondo le necessità.This socket option widens or narrows the scope of a listening socket, enabling unrestricted access from public and private users when appropriate, or restricting access only to the same site, as required. Questa opzione socket ha definito i livelli di protezione specificati nell'enumerazione IPProtectionLevel.This socket option has defined protection levels specified in the IPProtectionLevel enumeration.

IpTimeToLive IpTimeToLive IpTimeToLive IpTimeToLive 4

Imposta il campo della durata dell'intestazione IP.Set the IP header Time-to-Live field.

IPv6Only IPv6Only IPv6Only IPv6Only 27

Indica se un socket creato per la famiglia di indirizzi AF_INET6 è limitato solo alle comunicazioni IPv6.Indicates if a socket created for the AF_INET6 address family is restricted to IPv6 communications only. I socket creati per la famiglia di indirizzi AF_INET6 possono essere usati per le comunicazioni IPv6 e IPv4.Sockets created for the AF_INET6 address family may be used for both IPv6 and IPv4 communications. È possibile che in alcune applicazioni sia necessario limitare l'uso di un socket creato per la famiglia di indirizzi AF_INET6 alle sole comunicazioni IPv6.Some applications may want to restrict their use of a socket created for the AF_INET6 address family to IPv6 communications only. Quando questo valore è diverso da zero (l'impostazione predefinita in Windows), un socket creato per la famiglia di indirizzi AF_INET6 può essere usato per inviare e ricevere solo pacchetti IPv6.When this value is non-zero (the default on Windows), a socket created for the AF_INET6 address family can be used to send and receive IPv6 packets only. Quando questo valore è uguale a zero, un socket creato per la famiglia di indirizzi AF_INET6 può essere usato per inviare e ricevere pacchetti a e da un indirizzo IPv6 o IPv4.When this value is zero, a socket created for the AF_INET6 address family can be used to send and receive packets to and from an IPv6 address or an IPv4 address. Si noti che la possibilità di interagire con un indirizzo IPv4 richiede l'uso di indirizzi IPv4 mappati.Note that the ability to interact with an IPv4 address requires the use of IPv4 mapped addresses. Questa opzione socket è supportata in Windows Vista o versioni successive.This socket option is supported on Windows Vista or later.

KeepAlive KeepAlive KeepAlive KeepAlive 8

Usa keep-alive.Use keep-alives.

Linger Linger Linger Linger 128

Ritarda la chiusura se sono presenti dati non inviati.Linger on close if unsent data is present.

MaxConnections MaxConnections MaxConnections MaxConnections 2147483647

Non supportata; se usata, genera una SocketException.Not supported; will throw a SocketException if used.

MulticastInterface MulticastInterface MulticastInterface MulticastInterface 9

Imposta l'interfaccia per i pacchetti multicast in uscita.Set the interface for outgoing multicast packets.

MulticastLoopback MulticastLoopback MulticastLoopback MulticastLoopback 11

Loopback dell'IP multicast.An IP multicast loopback.

MulticastTimeToLive MulticastTimeToLive MulticastTimeToLive MulticastTimeToLive 10

Durata di un IP multicast.An IP multicast Time to Live.

NoChecksum NoChecksum NoChecksum NoChecksum 1

Invia datagrammi UDP con checksum impostato su zero.Send UDP datagrams with checksum set to zero.

NoDelay NoDelay NoDelay NoDelay 1

Disabilita l'algoritmo Nagle di unione dei pacchetti in invio.Disables the Nagle algorithm for send coalescing.

OutOfBandInline OutOfBandInline OutOfBandInline OutOfBandInline 256

Riceve dati fuori banda nel flusso dei dati normali.Receives out-of-band data in the normal data stream.

PacketInformation PacketInformation PacketInformation PacketInformation 19

Restituisce informazioni sui pacchetti ricevuti.Return information about received packets.

ReceiveBuffer ReceiveBuffer ReceiveBuffer ReceiveBuffer 4098

Specifica lo spazio totale di buffer per socket che deve essere riservato alle ricezioni.Specifies the total per-socket buffer space reserved for receives. Non esiste alcuna relazione con la dimensione massima dei messaggi o con la dimensione della finestra TCP.This is unrelated to the maximum message size or the size of a TCP window.

ReceiveLowWater ReceiveLowWater ReceiveLowWater ReceiveLowWater 4100

Specifica il limite minimo per le operazioni di Receive.Specifies the low water mark for Receive operations.

ReceiveTimeout ReceiveTimeout ReceiveTimeout ReceiveTimeout 4102

Riceve un timeout. Questa opzione è applicabile unicamente ai metodi sincroni; non influisce sui metodi asincroni quali il metodo BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object).Receive a time-out. This option applies only to synchronous methods; it has no effect on asynchronous methods such as the BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) method.

ReuseAddress ReuseAddress ReuseAddress ReuseAddress 4

Consente al socket di essere associato a un indirizzo già in uso.Allows the socket to be bound to an address that is already in use.

ReuseUnicastPort ReuseUnicastPort ReuseUnicastPort ReuseUnicastPort 12295

Indica che il sistema deve rinviare l'allocazione delle porte temporanee per le connessioni in uscita.Indicates that the system should defer ephemeral port allocation for outbound connections. Ciò equivale all'uso dell'opzione socket Winsock2 SO_REUSE_UNICASTPORT.This is equivalent to using the Winsock2 SO_REUSE_UNICASTPORT socket option.

SendBuffer SendBuffer SendBuffer SendBuffer 4097

Specifica lo spazio totale di buffer per socket che deve essere riservato agli invii.Specifies the total per-socket buffer space reserved for sends. Non esiste alcuna relazione con la dimensione massima dei messaggi o con la dimensione della finestra TCP.This is unrelated to the maximum message size or the size of a TCP window.

SendLowWater SendLowWater SendLowWater SendLowWater 4099

Specifica il limite minimo per le operazioni di Send.Specifies the low water mark for Send operations.

SendTimeout SendTimeout SendTimeout SendTimeout 4101

Invia un timeout. Questa opzione è applicabile unicamente ai metodi sincroni; non influisce sui metodi asincroni quali il metodo BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object).Send a time-out. This option applies only to synchronous methods; it has no effect on asynchronous methods such as the BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) method.

TcpKeepAliveInterval TcpKeepAliveInterval TcpKeepAliveInterval TcpKeepAliveInterval 17
TcpKeepAliveRetryCount TcpKeepAliveRetryCount TcpKeepAliveRetryCount TcpKeepAliveRetryCount 16
TcpKeepAliveTime TcpKeepAliveTime TcpKeepAliveTime TcpKeepAliveTime 3
Type Type Type Type 4104

Ottiene il tipo di socket.Gets the socket type.

TypeOfService TypeOfService TypeOfService TypeOfService 3

Modifica il campo relativo al tipo di servizio dell'intestazione IP.Change the IP header type of the service field.

UnblockSource UnblockSource UnblockSource UnblockSource 18

Sblocca un'origine precedentemente bloccata.Unblock a previously blocked source.

UpdateAcceptContext UpdateAcceptContext UpdateAcceptContext UpdateAcceptContext 28683

Aggiorna le proprietà di un socket accettato usando quelle di un socket esistente.Updates an accepted socket's properties by using those of an existing socket. Equivale a usare l'opzione socket Winsock2 SO_UPDATE_ACCEPT_CONTEXT ed è supportata solo sui socket orientati alla connessione.This is equivalent to using the Winsock2 SO_UPDATE_ACCEPT_CONTEXT socket option and is supported only on connection-oriented sockets.

UpdateConnectContext UpdateConnectContext UpdateConnectContext UpdateConnectContext 28688

Aggiorna le proprietà di un socket connesso usando quelle di un socket esistente.Updates a connected socket's properties by using those of an existing socket. Equivale a usare l'opzione socket Winsock2 SO_UPDATE_CONNECT_CONTEXT ed è supportata solo sui socket orientati alla connessione.This is equivalent to using the Winsock2 SO_UPDATE_CONNECT_CONTEXT socket option and is supported only on connection-oriented sockets.

UseLoopback UseLoopback UseLoopback UseLoopback 64

Ignora l'hardware quando possibile.Bypass hardware when possible.

Esempi

Esempio di codice seguente, questa enumerazione viene utilizzata per impostare le opzioni di socket.The following code example uses this enumeration to set socket options.

// 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)

Commenti

Il SocketOptionName enumerazione definisce il nome della ognuno Socket opzione di configurazione.The SocketOptionName enumeration defines the name of each Socket configuration option. Socket possono essere configurati con la Socket.SetSocketOption (metodo).Sockets can be configured with the Socket.SetSocketOption method.

Si applica a

Vedi anche