System.Net.Socket.TSocket.SendTo

• Aller au parent : TSocket

Delphi

function SendTo(const Buf; Count: Integer; Flags: Integer): Integer; overload; inline;
function SendTo(const Buf; Count: Integer; Flags: TSocketFlags = []): Integer; overload; inline;
function SendTo(const S: string; Flags: TSocketFlags = []): Integer; overload; inline;
function SendTo(const B: array of Byte; Offset: Integer = 0; Count: Integer = -1; Flags: TSocketFlags = []): Integer; overload;
function SendTo(const Buf; Count: Integer; const Endpoint: TNetEndpoint; Flags: Integer): Integer; overload;
function SendTo(const Buf; Count: Integer; const Endpoint: TNetEndpoint; Flags: TSocketFlags = []): Integer; overload; inline;
function SendTo(const S: string; const Endpoint: TNetEndpoint; Flags: TSocketFlags = []): Integer; overload;
function SendTo(const B: array of Byte; const Endpoint: TNetEndpoint; Offset: Integer = 0; Count: Integer = -1; Flags: TSocketFlags = []): Integer; overload;

C++

int __fastcall SendTo(const void *Buf, int Count, int Flags)/* overload */;
int __fastcall SendTo(const void *Buf, int Count, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall SendTo(const System::UnicodeString S, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall SendTo(System::Byte const *B, const int B_High, int Offset = 0x0, int Count = 0xffffffff, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall SendTo(const void *Buf, int Count, const TNetEndpoint &Endpoint, int Flags)/* overload */;
int __fastcall SendTo(const void *Buf, int Count, const TNetEndpoint &Endpoint, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall SendTo(const System::UnicodeString S, const TNetEndpoint &Endpoint, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall SendTo(System::Byte const *B, const int B_High, const TNetEndpoint &Endpoint, int Offset = 0x0, int Count = 0xffffffff, TSocketFlags Flags = TSocketFlags() )/* overload */;

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	System.Net.Socket.pas System.Net.Socket.hpp	System.Net.Socket	TSocket

Description

Envoie les données spécifiées au point de terminaison spécifié.

Vous pouvez transmettre les paramètres suivants à SendTo :

• Buf est un pointeur vers un tampon qui contient les données à envoyer.
• Offset est un nombre d'octets à ignorer au début des données à envoyer.
• Count est la longueur (en octets) du tampon pointé par Buf, qui est également la longueur maximale des données à envoyer.
• Flags est un ensemble d'indicateurs qui influence le comportement de SendTo. Pour de plus amples informations, voir la documentation de la fonction send (EN) sur MSDN.
• Endpoint est le point de terminaison cible.

Au lieu de fournir un pointeur vers un tampon (Buf), vous pouvez fournir une chaîne (S) ou un tableau d'octets (B).

Si les données spécifiées sont correctement envoyées, SendTo renvoie le nombre d'octets envoyés. Si votre socket n'est pas connecté, SendTo renvoie -1.

Exceptions

Un appel à SendTo peut déclencher l'une des exceptions suivantes :

Exception	Exception.Message	Scénarios
ESocketError	Erreur de socket réseau : <message d'erreur> (<code d'erreur>), sur la fonction 'sendto' de l'API	Le système d'exploitation a signalé une erreur lors de l'envoi de données sur votre socket. Pour de plus amples informations, voir la documentation suivante relative au système d'exploitation sur lequel votre application était exécutée : Windows : fonction sendto (MSDN) (EN) Mac OS X : sendto (OS X Man Pages) (EN) iOS : sendto (iOS Manual Pages) (EN) Android : sendto (Linux Programmer's Manual) (EN)

Voir aussi

• System.Byte
• System.SysUtils.TBytes
• System.String

• System.Net.Socket.TSocket.BeginSendTo
• System.Net.Socket.TSocket.EndSendTo

• System.Net.Socket.TSocket.Accept
• System.Net.Socket.TSocket.ReceiveFrom

• System.Net.Socket.TSocket.Send

• Fonction sendto (EN) (MSDN)