System.Net.Socket.TSocket.SendTo

• Übergeordnet: 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(const System::Byte *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(const System::Byte *B, const int B_High, const TNetEndpoint &Endpoint, int Offset = 0x0, int Count = 0xffffffff, TSocketFlags Flags = TSocketFlags() )/* overload */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	System.Net.Socket.pas System.Net.Socket.hpp	System.Net.Socket	TSocket

Beschreibung

Sendet die angegebenen Daten an den angegebenen Endpunkt.

Sie können an SendTo die folgenden Parameter übergeben:

• Buf ist ein Zeiger auf einen Puffer, der die zu sendenen Daten enthält.
• Offset ist eine Byte-Anzahl, die am Beginn der zu sendenden Daten übersprungen werden soll.
• Count ist die Länge (in Byte) des Puffers, auf den von Buf gezeigt wird. Dies ist zudem die maximale Länge der zu sendenen Daten.
• Flags ist ein Flag-Satz, der das Verhalten von SendTo beeinflusst. Weitere Informationen finden Sie in der Dokumentation der Funtion send auf der MSDN-Website.
• Endpoint ist der Zielendpunkt.

Anstatt einen Zeiger auf einen Puffer (Buf) bereitzustellen, können Sie auch einen String (S) oder ein Byte-Array (B) angeben.

Wenn die angegebenen Daten erfolgreich gesendet wurden, gibt SendTo die Anzahl der gesendeten Bytes zurück. Wenn Ihr Socket nicht verbunden ist, dann gibt SendTo -1 zurück.

Exceptions

Ein Aufruf von SendTo kann eine der folgenden Exceptions auslösen:

Exception	Exception.Message	Szenarien
ESocketError	Netzwerk-Socket-Fehler: <Fehlermeldung> (<Fehlercode>), bei API 'sendto'	Das Betriebssystem hat beim beim Senden von Daten über Ihren Socket einen Fehler gemeldet. Weitere Informationen finden Sie in der folgenden Dokumentation für das Betriebssystem, auf dem Ihre Anwendung ausgeführt wurde: Windows: Funktion sendto (MSDN) OS X: sendto (OS X Man Pages) iOS: sendto (iOS Manual Pages) Android: sendto (Linux Programmer's Manual)

Siehe auch

• 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

• Funktion sendto (MSDN)