Socket.ReceiveMessageFrom Método

public:
 int ReceiveMessageFrom(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags % socketFlags, System::Net::EndPoint ^ % remoteEP, [Runtime::InteropServices::Out] System::Net::Sockets::IPPacketInformation % ipPacketInformation);

public int ReceiveMessageFrom(byte[] buffer, int offset, int size, ref System.Net.Sockets.SocketFlags socketFlags, ref System.Net.EndPoint remoteEP, out System.Net.Sockets.IPPacketInformation ipPacketInformation);

member this.ReceiveMessageFrom : byte[] * int * int * SocketFlags * EndPoint * IPPacketInformation -> int

Public Function ReceiveMessageFrom (buffer As Byte(), offset As Integer, size As Integer, ByRef socketFlags As SocketFlags, ByRef remoteEP As EndPoint, ByRef ipPacketInformation As IPPacketInformation) As Integer

Parâmetros

Devoluções

O número de bytes recebidos.

Exceções

Observações

O ReceiveMessageFrom método lê dados no buffer parâmetro, devolve o número de bytes lidos com sucesso e captura o endpoint remoto do host de onde os dados foram enviados, bem como informações sobre o pacote recebido.

O ReceiveMessageFrom método é usado principalmente para receber dados de mensagens num socket sem conexão. O endereço local do socket deve ser conhecido. Este método só pode ser usado com datagramas e sockets brutos. O socket deve ser inicializado com o tipo de socket definido como Dgram ou Raw antes de chamar este método. Isto pode ser feito quando o soquete é construído usando Socket.

Para sockets orientados a mensagens, uma mensagem recebida é colocada no buffer parâmetro até ao tamanho total especificado no size parâmetro. O offset parâmetro determina onde buffer os dados são colocados. A quantidade real de dados inseridos no buffer é devolvida pelo ReceiveMessageFrom método.

O ReceiveMessageFrom método define automaticamente a PacketInformation opção de soquete para true a primeira vez que é chamada para um dado Socket. No entanto, o objeto devolvido IPPacketInformation só será válido para pacotes que chegam ao computador local depois de a opção socket ter sido definida. Se um socket for enviado pacotes entre o momento em que está ligado a um ponto terminal local (explicitamente pelo Bind método ou implicitamente por um dos Connectmétodos , , SendTo, ou por um dos métodos , ConnectAsyncou SendToAsync pela sua primeira chamada ao ReceiveMessageFrom método, as chamadas ao ReceiveMessageFrom método retornarão objetos inválidos IPPacketInformation para esses pacotes.

Para garantir que todos IPPacketInformation os objetos são válidos, uma aplicação deve definir a PacketInformation opção socket para true antes de ser associada a um endpoint local usando o SetSocketOption(SocketOptionLevel, SocketOptionName, Boolean) método.

Uma aplicação pode examinar o ipPacketInformation parâmetro se precisar de saber se o datagrama foi enviado usando um endereço unicast, multicast ou broadcast.

Ver também

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()