CAsyncSocket::ReceiveFromEx

Artigo
02/25/2013

Chamar essa função de membro para receber uma datagrama e para armazenar o endereço de origem na estrutura de SOCKADDR ou em rSocketAddress endereços IPV6 (handles).

int ReceiveFromEx(
   void* lpBuf,
   int nBufLen,
   CString& rSocketAddress,
   UINT& rSocketPort,
   int nFlags = 0 
);

Parâmetros

lpBuf
Um buffer para os dados de entrada.
nBufLen
O comprimento de lpBuf em bytes.
rSocketAddress
Referência a um objeto de CString que recebe um endereço IP pontilhada de números.
rSocketPort
Referência a UINT que armazena uma porta.
nFlags
Especifica a maneira na qual o chamada é feita.A semântica de essa função é determinada pelas opções de soquete e pelo parâmetro de nFlags .O segundo é construído combinando alguns dos seguintes valores com o operador de OR C++:
- Auge deMSG_PEEK nos dados de entrada.Os dados são copiados para o buffer mas não removidos da fila de entrada.
- Dados de banda fora de processo deMSG_OOB .

Valor de retorno

Se nenhum erro ocorre, ReceiveFromEx retorna o número de bytes recebidos.Se a conexão foi fechada, retornará 0.Caso contrário, um valor de SOCKET_ERROR é retornado, e um código de erro específico pode ser recuperado chamando GetLastError.Os seguintes erros se aplicam a essa função de membro:

WSANOTINITIALISED A AfxSocketInit com êxito deve ocorrer antes de usar este API.
WSAENETDOWN a implementação da do windows detectou que o subsistema de rede falhou.
WSAEFAULT o argumento de lpSockAddrLen era inválido: o buffer de lpSockAddr foi muito pequeno acomodar o endereço do ponto.
A operação de soquetes do windows de bloqueio deWSAEINPROGRESS A está em andamento.
WSAEINVAL o soquete não foi associado com Ligar.
WSAENOTCONN o soquete não está conectado (SOCK_STREAM somente).
WSAENOTSOCK o descritor não for um soquete.
WSAEOPNOTSUPP MSG_OOB foi especificado, mas o soquete não é do tipo SOCK_STREAM.
WSAESHUTDOWN o soquete foi fechada; não é possível chamar ReceiveFromEx em um soquete após ShutDown foi chamado com nHow definido como 0 ou 2.
WSAEWOULDBLOCK o soquete é marcado como nonblocking e a operação de ReceiveFromEx bloquearia.
WSAEMSGSIZE a datagrama foi muito grande caber no buffer foi especificado e truncado.
WSAECONNABORTED o circuito virtual foi anuladas devido ao tempo limite ou outra falha.
WSAECONNRESET o circuito virtual foi redefinido pelo lado do servidor remoto.

Comentários

Essa função é usada para ler dados de entrada em soquete de conectado (possivelmente) e detectar o endereço dos dados que foram enviados.

Essa função é a mesma que CAsyncSocket::ReceiveFrom exceto que trata bem como endereços IPV6 protocolos mais antigos.

Para os soquetes de tipo SOCK_STREAM, tanta informação quanto está disponível no momento até o tamanho do buffer fornecido é retornada.Se o soquete foi configurado para receptor in-line de dados fora de banda (padrão SO_OOBINLINEde soquete) e os dados fora de banda são unread, somente os dados fora de banda serão retornados.O aplicativo pode usar a opção ou OnOutOfBandData de IOCtlSIOCATMARK determinar se any outras dados fora de banda permanecem ser lidos.Os parâmetros de lpSockAddr e de lpSockAddrLen são ignorados para os soquetes de SOCK_STREAM .

Para os soquetes de datagrama, os dados são extraídos da primeira datagrama enviada para a fila, até o tamanho do buffer fornecido.Se a datagrama é maior do que o buffer fornecido, o buffer é preenchido com a primeira parte de mensagem, os dados adicionais são perdidos, e retornos de ReceiveFromEx um valor de SOCKET_ERROR com o código de erro definido como WSAEMSGSIZE.

Se lpSockAddr é diferente de zero, e o soquete é do tipo SOCK_DGRAM, o endereço de rede de soquete que envia os dados é copiado para a estrutura de SOCKADDR correspondente.O valor apontado por lpSockAddrLen é inicializado para o tamanho de essa estrutura, e modificado em retorno para indicar o tamanho real de endereço armazenado localmente.Se nenhum dados de entrada está disponível em soquete, a chamada de ReceiveFromEx espera dados para chegar a menos que o soquete é nonblocking.Em esse caso, um valor de SOCKET_ERROR é retornado pelo código de erro definido como WSAEWOULDBLOCK.O retorno de chamada de OnReceive pode ser usado para determinar quando dados mais chegam.

Se o soquete é do tipo SOCK_STREAM e o lado do servidor remoto desliga graciosamente a conexão, ReceiveFromEx concluirá imediatamente com os 0 bytes recebidos.