SocketOptionName Enumeração

Definição

Define os nomes de opções de configuração.Defines configuration option names.

public enum class SocketOptionName
public enum SocketOptionName
type SocketOptionName = 
Public Enum SocketOptionName
Herança
SocketOptionName

Campos

AcceptConnection 2

O soquete está escutando.The socket is listening.

AddMembership 12

Adiciona uma associação de grupo IP.Add an IP group membership.

AddSourceMembership 15

Ingressa em um grupo de origem.Join a source group.

BlockSource 17

Bloqueia dados de uma fonte.Block data from a source.

Broadcast 32

Permite o envio de mensagens de difusão no soquete.Permit sending broadcast messages on the socket.

BsdUrgent 2

Usa dados urgentes conforme definido em RFC-1222.Use urgent data as defined in RFC-1222. Essa opção pode ser definida apenas uma vez; depois de definida, ela não poderá ser desativada.This option can be set only once; after it is set, it cannot be turned off.

ChecksumCoverage 20

Define ou obtém a cobertura de soma de verificação UDP.Set or get the UDP checksum coverage.

Debug 1

Registre informações de depuração.Record debugging information.

DontFragment 14

Não fragmenta os datagramas IP.Do not fragment IP datagrams.

DontLinger -129

Fecha o soquete normalmente sem demorar-se.Close the socket gracefully without lingering.

DontRoute 16

Não faz roteamento; envia o pacote diretamente aos endereços de interface.Do not route; send the packet directly to the interface addresses.

DropMembership 13

Remove uma associação de grupo IP.Drop an IP group membership.

DropSourceMembership 16

Remove um grupo de origem.Drop a source group.

Error 4103

Obtém o status de erro e limpa.Gets the error status and clear.

ExclusiveAddressUse -5

Permite limitar um soquete para acesso exclusivo.Enables a socket to be bound for exclusive access.

Expedited 2

Use os dados expressos conforme definido em RFC-1222.Use expedited data as defined in RFC-1222. Essa opção pode ser definida apenas uma vez; depois de definida, ela não poderá ser desativada.This option can be set only once; after it is set, it cannot be turned off.

HeaderIncluded 2

Indica que o aplicativo fornece o cabeçalho IP para datagramas de saída.Indicates that the application provides the IP header for outgoing datagrams.

HopLimit 21

Especifica que o número máximo de saltos do roteador para um pacote IPv6 (Protocolo de Internet versão 6).Specifies the maximum number of router hops for an Internet Protocol version 6 (IPv6) packet. Isso é semelhante à TTL (vida útil) para o protocolo IP versão 4.This is similar to Time to Live (TTL) for Internet Protocol version 4.

IPOptions 1

Especifica as opções IP a serem inseridas nos datagramas enviados.Specifies the IP options to be inserted into outgoing datagrams.

IPProtectionLevel 23

Habilita a restrição de um soquete de IPv6 para um escopo especificado, como endereços com o mesmo local de link ou o prefixo de local do site. Essa opção de soquete permite aos aplicativos impor restrições de acesso a soquetes 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. Essas restrições permitem que um aplicativo em execução em uma LAN privada proteja-se de modo simples e robusto contra ataques externos.Such restrictions enable an application running on a private LAN to simply and robustly harden itself against external attacks. Essa opção de soquete amplia ou reduz o escopo de um soquete de escuta, permitindo acesso irrestrito de usuários públicos e privados, quando apropriado, ou restringindo o acesso somente ao mesmo site, conforme necessário.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. Essa opção de soquete definiu os níveis de proteção especificados na enumeração IPProtectionLevel.This socket option has defined protection levels specified in the IPProtectionLevel enumeration.

IpTimeToLive 4

Define o campo de Vida Útil do cabeçalho IP.Set the IP header Time-to-Live field.

IPv6Only 27

Indica se um soquete criado para a família de endereços AF_INET6 é restrito a apenas comunicações IPv6.Indicates if a socket created for the AF_INET6 address family is restricted to IPv6 communications only. Soquetes criados para a família de endereços AF_INET6 podem ser usados para comunicações IPv6 e IPv4.Sockets created for the AF_INET6 address family may be used for both IPv6 and IPv4 communications. Alguns aplicativos podem querer restringir o uso de um soquete criado para a família de endereço AF_INET6 a apenas comunicações IPv6.Some applications may want to restrict their use of a socket created for the AF_INET6 address family to IPv6 communications only. Quando esse valor é diferente de zero (o padrão no Windows), um soquete criado para a família de endereço AF_INET6 pode ser usada para enviar e receber apenas os pacotes 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 esse valor é zero, um soquete criado para a família de endereço AF_INET6 pode ser usado para enviar e receber pacotes para e de um endereço IPv6 ou um endereç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. Observe que a capacidade de interagir com endereços IPv4 requer o uso dos endereços IPv4 mapeados.Note that the ability to interact with an IPv4 address requires the use of IPv4 mapped addresses. Essa opção de soquete tem suporte no Windows Vista ou posterior.This socket option is supported on Windows Vista or later.

KeepAlive 8

Usa os keep alives.Use keep-alives.

Linger 128

Demora no fechamento caso haja dados não enviados.Linger on close if unsent data is present.

MaxConnections 2147483647

Não tem suporte; lança um SocketException, se usado.Not supported; will throw a SocketException if used.

MulticastInterface 9

Define a interface para pacotes multicast de saída.Set the interface for outgoing multicast packets.

MulticastLoopback 11

Um loopback de multicast IP.An IP multicast loopback.

MulticastTimeToLive 10

A vida útil de um multicast IP.An IP multicast Time to Live.

NoChecksum 1

Envia datagramas UDP com soma de verificação definida como zero.Send UDP datagrams with checksum set to zero.

NoDelay 1

Desabilita o algoritmo Nagle para união de envio.Disables the Nagle algorithm for send coalescing.

OutOfBandInline 256

Recebe dados fora de banda no fluxo de dados normal.Receives out-of-band data in the normal data stream.

PacketInformation 19

Retorna informações sobre pacotes recebidos.Return information about received packets.

ReceiveBuffer 4098

Especifica o espaço de buffer por soquete total reservado para recebimentos.Specifies the total per-socket buffer space reserved for receives. Isso não está relacionado ao tamanho máximo da mensagem ou ao tamanho de uma janela TCP.This is unrelated to the maximum message size or the size of a TCP window.

ReceiveLowWater 4100

Especifica a marca d'água inferior para operações Receive.Specifies the low water mark for Receive operations.

ReceiveTimeout 4102

Receber um tempo limite. Essa opção se aplica apenas aos métodos síncronos; ela não tem efeitos sobre métodos assíncronos, como o método 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 4

Permite associar o soquete a um endereço que já está em uso.Allows the socket to be bound to an address that is already in use.

ReuseUnicastPort 12295

Indica que o sistema deve adiar a alocação de porta efêmera para conexões de saída.Indicates that the system should defer ephemeral port allocation for outbound connections. Isso é equivalente a usar a opção de soquete SO_REUSE_UNICASTPORT Winsock2.This is equivalent to using the Winsock2 SO_REUSE_UNICASTPORT socket option.

SendBuffer 4097

Especifica o espaço de buffer por soquete total reservado para envios.Specifies the total per-socket buffer space reserved for sends. Isso não está relacionado ao tamanho máximo da mensagem ou ao tamanho de uma janela TCP.This is unrelated to the maximum message size or the size of a TCP window.

SendLowWater 4099

Especifica a marca d'água inferior para operações Send.Specifies the low water mark for Send operations.

SendTimeout 4101

Enviar um tempo limite. Essa opção se aplica apenas aos métodos síncronos; ela não tem efeitos sobre métodos assíncronos, como o método 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 17

O número de segundos que uma conexão TCP aguardará por uma resposta de manutenção de atividade antes de enviar outra investigação de manutenção de atividade.The number of seconds a TCP connection will wait for a keepalive response before sending another keepalive probe.

TcpKeepAliveRetryCount 16

O número de investigações de manutenção de atividade de TCP que serão enviadas antes que a conexão seja encerrada.The number of TCP keep alive probes that will be sent before the connection is terminated.

TcpKeepAliveTime 3

O número de segundos que uma conexão TCP permanecerá ativa/ociosa antes que investigações de manutenção de atividade sejam enviadas para o remoto.The number of seconds a TCP connection will remain alive/idle before keepalive probes are sent to the remote.

Type 4104

Obtém o tipo de soquete.Gets the socket type.

TypeOfService 3

Altera o tipo de cabeçalho IP do campo de serviço.Change the IP header type of the service field.

UnblockSource 18

Desbloqueia uma fonte bloqueada anteriormente.Unblock a previously blocked source.

UpdateAcceptContext 28683

Atualiza as propriedades de um soquete aceito usando aquelas de um soquete existente.Updates an accepted socket's properties by using those of an existing socket. Isso é equivalente a usar a opção de soquete SO_UPDATE_ACCEPT_CONTEXT Winsock2 e tem suporte apenas em soquetes orientados a conexão.This is equivalent to using the Winsock2 SO_UPDATE_ACCEPT_CONTEXT socket option and is supported only on connection-oriented sockets.

UpdateConnectContext 28688

Atualiza as propriedades de um soquete conectado usando aquelas de um soquete existente.Updates a connected socket's properties by using those of an existing socket. Isso é equivalente a usar a opção de soquete SO_UPDATE_CONNECT_CONTEXT Winsock2 e tem suporte apenas em soquetes orientados a conexão.This is equivalent to using the Winsock2 SO_UPDATE_CONNECT_CONTEXT socket option and is supported only on connection-oriented sockets.

UseLoopback 64

Ignora o hardware quando possível.Bypass hardware when possible.

Exemplos

O exemplo de código a seguir usa essa enumeração para definir opções de soquete.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)

Comentários

A enumeração SocketOptionName define o nome de cada opção de configuração de Socket.The SocketOptionName enumeration defines the name of each Socket configuration option. Os soquetes podem ser configurados com o método Socket.SetSocketOption.Sockets can be configured with the Socket.SetSocketOption method.

Aplica-se a

Veja também