System.Tether.AppProfile.TTetheringAppProfile.SendStream

提供: RAD Studio API Documentation
移動先: 案内検索

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 シナリオ

ETetheringException

プロファイル <プロファイル識別子> が見つかりません。

プロファイル <プロファイル識別子> は接続されていません。

  • AProfile は接続されていません。

<プロファイル識別子> への接続がありません。

プロファイル <プロファイル識別子>への接続を取得することができません。

  • SendStream は、AProfile への接続を取得することができませんでした。

プロファイル <プロファイル識別子> へ接続できません。

関連項目