System.Net.Socket.TSocket.Send
Delphi
function Send(const Buf; Count: Integer; Flags: Integer): Integer; overload;
function Send(const Buf; Count: Integer; Flags: TSocketFlags = []): Integer; overload; inline;
function Send(const S: string; Flags: TSocketFlags = []): Integer; overload;
function Send(const B: TBytes; Offset: Integer = 0; Count: Integer = -1; Flags: TSocketFlags = []): Integer; overload;
function Send(const B: array of Byte; Offset: Integer = 0; Count: Integer = -1; Flags: TSocketFlags = []): Integer; overload;
C++
int __fastcall Send(const void *Buf, int Count, int Flags)/* overload */;
int __fastcall Send(const void *Buf, int Count, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall Send(const System::UnicodeString S, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall Send(const System::DynamicArray<System::Byte> B, int Offset = 0x0, int Count = 0xffffffff, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall Send(const System::Byte *B, const int B_High, int Offset = 0x0, int Count = 0xffffffff, TSocketFlags Flags = TSocketFlags() )/* overload */;
Inhaltsverzeichnis
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 verbundenen Endpunkt.
Sie können an Send die folgenden Parameter übergeben:
Buf
ist ein Zeiger auf einen Puffer. der die zu sendenden 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 vonBuf
gezeigt wird. Dies ist zudem die maximale Länge der zu sendenden Daten.Flags
ist ein Flag-Satz, der das Verhalten von Send beeinflusst. Weitere Informationen finden Sie in der Dokumentation der Funktion send auf der MSDN-Website.
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 Send die Anzahl der gesendeten Bytes zurück. Wenn Ihr Socket nicht verbunden ist, gibt Send -1 zurück.
Exceptions
Ein Aufruf von Send kann eine der folgenden Exceptions auslösen:
Exception | Exception.Message | Szenarien |
---|---|---|
Netzwerk-Socket-Fehler: <Fehlermeldung> (<Fehlercode>), bei API 'send' |
| |
Socket-Typ nicht kompatibel mit Aufruf |
|
Siehe auch
- Funktion send (MSDN)