Compartilhar via


WSPShutdown

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Essa função desativa envia e / ou recebe em um Soquete.

Syntax

int WSPShutdown(
  SOCKET s,
  int how,
  LPINT lpErrno 
);

Parameters

  • s
    [no] Descritor identificando um Soquete.
  • Como
    [no] Sinalizador que descreve quais tipos de operação não será permitido.
  • lpErrno
    [out] Ponteiro para o código de erro.

Return Value

Se não houver erro, WSPShutdown 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.

WSAEINVAL

O Como não é válido, ou é não consistente com o tipo Soquete. De exemplo, SD_SEND é usado com um tipo Soquete UNI_RECV.

WSAEINPROGRESS

Função é chamada quando um callback é em andamento.

WSAENOTCONN

Soquete não está conectados (orientado à conexão soquetes somente).

WSAENOTSOCK

O descritor não é um Soquete.

Remarks

Esta função é usado em todos os tipos de soquetes para desativar recepção, transmissão ou ambos.

Se Como é SD_RECEIVE, recebe subseqüentes no Soquete será ser desativado. Isso não tem nenhum efeito em camadas de protocolo inferiores. Para Soquetes TCP, se ainda houver dados enfileirado sobre o Soquete que estão aguardando para ser recebido, ou dados chegarem posteriormente, a conexão é redefinir, pois os dados não podem ser entregue para o usuário. Para soquetes UDP, de entrada datagramas são aceitas e enfileirado. Em nenhuma maiúsculas e minúsculas será um pacote de erro ICMP gerado.

Se Como é SD_SEND, envia subseqüente na Soquete é permitida. Para Soquetes TCP, um FIN será enviada. Configuração Como Para SD_BOTH desativa ambos envia e recebe conforme descrito acima.

Observação

WSPShutdown Não fechar o Soquete e recursos será anexado para o Soquete Não ser liberado até WSPCloseSocket é invocado.

WSPShutdown Não bloco independentemente do SO_LINGER configuração sobre o Soquete. Um cliente Windows Sockets SPI não deve depender poder reutilizar um Soquete após ele foi desligado. Em particular, um provedor serviço Soquetes do Windows não é exigido para suporte o uso de WSPConnect Em tal um Soquete.

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

WSPConnect
WSPSocket