System.Tether.AppProfile.TTetheringAppProfile.SendStream
Delphi
function SendStream(const AProfile: TTetheringProfileInfo; const Description: string; const AStream: TStream): Boolean;
C++
bool __fastcall SendStream(const System::Tether::Manager::TTetheringProfileInfo &AProfile, const System::UnicodeString Description, System::Classes::TStream* const AStream);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | System.Tether.AppProfile.pas System.Tether.AppProfile.hpp |
System.Tether.AppProfile | TTetheringAppProfile |
説明
指定されたストリームを指定されたリモート プロファイルへ送信し、成功した場合には True
を、失敗した場合には False
を返します。
この関数は、次のパラメータを受け取ります:
AProfile
は、ストリームを受け取るリモート プロファイルです。Description
はストリームの内容の説明です。AStream
は送信されるストリームです。
リモート プロファイルでは、ストリームを一時的なリソースとして受け取ります。ストリームを受け取ったリモート プロファイルでは、ストリームを受け入れるかどうかを判断することができ、受け入れる場合にストリームを読み取ります。
SendStream は、ストリームの送信中に接続エラーが発生すると False
を返します。それ以外の場合には True
を返します。ストリームは、リモート プロファイルがストリームを受け入れるかどうかを判断する前にリモート プロファイルに送信されます。そのため、リモート プロファイルがストリームを拒否したにもかかわらず、ストリームの送信は既に成功しているため SendStream からは True
が返されるということがあり得ます。リモート プロファイルがストリームを受け入れたかどうかを知るための組み込みのメカニズムはありません。
SendStream は同期関数です。この関数はリモート プロファイルへの要求を実行し、リモート プロファイルから応答があった場合にのみ関数の実行が終了します。別個のスレッドを使用して、この関数を実行するとよいでしょう。
例外
SendStream への呼び出しは、次の例外のいずれかを発生させます:
Exception | Exception.Message | シナリオ |
---|---|---|
プロファイル <プロファイル識別子> が見つかりません。 |
| |
プロファイル <プロファイル識別子> は接続されていません。 |
| |
<プロファイル識別子> への接続がありません。 |
| |
プロファイル <プロファイル識別子>への接続を取得することができません。 |
| |
プロファイル <プロファイル識別子> へ接続できません。 |
|
関連項目
- System.Tether.AppProfile.TCustomRemoteItem.IsTemp
- System.Tether.AppProfile.TTetheringAppProfile.OnAcceptResource
- System.Tether.AppProfile.TTetheringAppProfile.OnResourceReceived
- System.Tether.Manager.TTetheringProfile.Manager
- System.Tether.Manager.TTetheringManager.RemoteProfiles
- PhotoWall サンプル