WSPShutdown
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
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 |