System.Tether.AppProfile.TTetheringAppProfile.SendLongString

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

Delphi 

function SendLongString(const AProfile: TTetheringProfileInfo; const Description, AString: string): Boolean;

C++ 

bool __fastcall SendLongString(const System::Tether::Manager::TTetheringProfileInfo &AProfile, const System::UnicodeString Description, const System::UnicodeString AString);

プロパティ

種類 可視性 ソース ユニット 親
function public
System.Tether.AppProfile.pas
System.Tether.AppProfile.hpp
 System.Tether.AppProfile TTetheringAppProfile


説明

指定された文字列を、指定されたリモート プロファイルに送信します。

この関数は、次のパラメータを受け取ります：

  • AProfile は文字列を受け取るリモート プロファイルです。
  • Description は、文字列のコンテンツの説明です。
  • AString は送信される文字列です。

リモート プロファイルは、"文字列送信"コマンドのパラメータとして文字列を受け取り、したがって、リモート プロファイルは（SendStream の場合のように）文字列を個別に受け入れたり受信したりする必要はありません。これは、リモート プロファイルが文字列を受信するかどうかを選択できないことを意味します。 この関数は、リモート プロファイルがコマンドを受信すると、True を返します。

SendLongString は、同期関数です。この関数はリモート プロファイルへの要求を実行し、関数の実行はリモート プロファイルからの応答があった後にのみ終了します。この関数を実行するには別のスレッドを使用することをお勧めします。

メモ: この関数は、コマンド内で文字列を送ることで（それ故、文字列を送る余分なステップを削除できるため）処理をシンプルにでき、実行が SendStream の実行より高速化することができます。

例外

SendLongString への呼び出しは、次の例外のいずれかを発生させる可能性があります：

Exception Exception.Message シナリオ

ETetheringException

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

  • AProfile が接続されていない。

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

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

  • SendLongString が AProfile への接続を取得できませんでした。

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

注意: SendLongString は、文字列の長さが 1.3 KB を超える場合にのみ使用する必要があります。それ以外の場合は、SendString を使用します。

関連項目

「http://docwiki.embarcadero.com/Libraries/Sydney/j/index.php?title=System.Tether.AppProfile.TTetheringAppProfile.SendLongString&oldid=783447」から取得