Socket.ReceiveMessageFrom Méthode

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

Paramètres

Retours

Nombre d’octets reçus.

Exceptions

Remarques

La ReceiveMessageFrom méthode lit les données dans le buffer paramètre, retourne le nombre d’octets lus correctement et capture le point de terminaison hôte distant à partir duquel les données ont été envoyées, ainsi que des informations sur le paquet reçu.

La ReceiveMessageFrom méthode est utilisée principalement pour recevoir des données de message sur un socket sans connexion. L’adresse locale du socket doit être connue. Cette méthode ne peut être utilisée qu’avec le datagramme et les sockets bruts. Le socket doit être initialisé avec le type de socket défini sur Dgram ou Raw avant d’appeler cette méthode. Pour ce faire, lorsque le socket est construit à l’aide Socketde .

Pour les sockets orientés messages, un message entrant est placé dans le buffer paramètre jusqu’à la taille totale spécifiée dans le size paramètre. Le offset paramètre détermine l’emplacement dans les buffer données. La quantité réelle de données placées dans la bufferReceiveMessageFrom méthode est retournée.

La ReceiveMessageFrom méthode définit automatiquement l’option PacketInformationtrue de socket sur la première fois qu’elle est appelée pour une donnée Socket. Toutefois, l’objet retourné IPPacketInformation n’est valide que pour les paquets qui arrivent à l’ordinateur local une fois que l’option de socket a été définie. Si un socket est envoyé des paquets entre le moment où il est lié à un point de terminaison local (explicitement par la Bind méthode ou implicitement par l’un des Connectpaquets , ConnectAsyncou SendToAsyncSendTométhodes) et son premier appel à la méthode, les appels à ReceiveMessageFrom la ReceiveMessageFrom méthode retournent des objets non valides IPPacketInformation pour ces paquets.

Pour vous assurer que tous les IPPacketInformation objets sont valides, une application doit définir l’option PacketInformationtrue de socket avant qu’elle soit liée à un point de terminaison local à l’aide de la SetSocketOption(SocketOptionLevel, SocketOptionName, Boolean) méthode.

Une application peut examiner le ipPacketInformation paramètre s’il doit savoir si le datagramme a été envoyé à l’aide d’une monodiffusion, d’une multidiffusion ou d’une adresse de diffusion.

Voir aussi

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