WSPSetSockOpt

9/8/2008

Essa função define uma opção Soquete.

Syntax

int WSPSetSockOpt(
  SOCKET s,
  int level,
  int optname,
  const char FAR* optval,
  int optlen,
  LPINT lpErrno 
);

Parameters

• s
  [no] Descritor identificando um Soquete.

• nível
  [no] Nível no qual a opção está definida; o com suporte nívels incluem SOL_SOCKET. A seguinte tabela mostra valores possíveis para esse parâmetro. A exibição opções SOL_SOCKET que são são com suporte para WSPSetSockOpt, consulte SOL_SOCKET.

• OptName
  [no] Para que o valor é possível definir opção Soquete.

• optval
  [no] Ponteiro para a reserva em que o valor para a opção solicitada é fornecido.

• optlen
  [no] Tamanho das optval reserva.

• lpErrno
  [out] Ponteiro para o código de erro.

Return Value

Se não houver erro, WSPSetSockOpt Retorna zero. Caso contrário, será retornado um valor de SOCKET_ERROR e um código de erro específico está disponível em lpErrno.

A seguinte tabela mostra os códigos de erro possível.

Valor de erro	Descrição
WSAENETDOWN	falha no subsistema de rede.
WSAEFAULT	O optval não está em um válido parte espaço de endereço o processo ou optlen parâmetro é muito pequeno.
WSAEINPROGRESS	Função é chamada quando um callback é em andamento.
WSAEINPROGRESS	Bloquear chamar Soquetes do Windows é em andamento, ou o serviço provedor ainda é processamento um função callback.
WSAEINVAL	O nível não é válido ou as informações em optval não é válido.
WSAENETRESET	Conexão foi interrompida detectar uma falha enquanto a operação foi atividade keep-alive devido a em andamento.
WSAENOPROTOOPT	Opção é desconhecida ou sem suporte para o provedor especificado.
WSAENOTCONN	Conexão tenha sido redefinir quando SO_KEEPALIVE está definido.
WSAENOTSOCK	O descritor não é um Soquete.

Remarks

Essa função define o atual valor para uma opção Soquete associado com um Soquete de qualquer tipo, em qualquer estado. Embora as opções podem existir no múltiplo protocolo níveis, eles são sempre presentes na primeira Soquete nível. Opções afetam operações Soquete, como se transmitir mensagens podem ser enviadas na Soquete.

Há dois tipos de opções Soquete: Boolean as opções que habilitar ou desativar comportamento e as opções que requerem um valor inteiro ou estrutura. Para habilitar um Boolean opção, optval aponta para um diferente de zero inteiro. Para desativar a opção, optval aponta para um inteiro igual a zero. O optlen parâmetro deve ser igual a sizeof (INT) para Boolean opções. Para obter outras opções, optval Aponta para a um inteiro ou estrutura que contém o valor desejado para a opção, e optlen é o comprimento do inteiro ou estrutura.

Chamando WSPGetSockOpt Com um sem suporte opção resultará em um código de erro de WSAENOPROTOOPT sendo retornado em lpErrno.

Requirements

Header	ws2spi.h
Library	Ws2.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

WSPBind
WSPGetSockOpt
WSPIoctl
WSPSocket
WSPEventSelect

Concepts

Socket Options