System.Net.Socket.TSocket.SendTo
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 */;
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | public | System.Net.Socket.pas System.Net.Socket.hpp |
System.Net.Socket | TSocket |
説明
指定されたデータを指定されたエンドポイントに送信します。
SendTo には、次のパラメータを渡すことができます：
Bufは、送るデータが格納されているバッファへのポインタです。Offsetは、送るデータの先頭からスキップするバイト数です。Countは、Bufが指しているバッファの長さ（バイト）で、これは、送るデータの最大長でもあります。Flagsは、SendTo の動作に作用するフラグのセットです。詳細については、MSDN で send 関数のドキュメントを参照してください。Endpointは、ターゲット エンドポイントです。
バッファへのポインタ（Buf）を提供する代わりに、文字列（S）やバイトの配列（B）を提供することも可能です。
指定したデータの送信が成功すると、SendTo は送信されたバイト数を返します。 ソケットが接続されていない場合、SendTo は -1 を返します。
例外
SendTo への呼び出しは、次の例外のいずれかを発生させます：
| Exception | Exception.Message | シナリオ |
|---|---|---|
|
Network socket error: <error message> (<error code>), on API 'sendto' |
|
関連項目
- sendto 関数（MSDN）