System.Tether.AppProfile.TTetheringAppProfile.SendString

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

Delphi 

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

C++ 

bool __fastcall SendString(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 を返します。

SendString は同期関数です。この関数はリモート プロファイルへの要求を実行し、リモート プロファイルから応答があった場合にのみ関数の実行が終了します。別個のスレッドを使用して、この関数を実行するとよいでしょう。

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

例外

SendString への呼び出しは、次の例外のいずれかを発生させます：

Exception Exception.Message シナリオ

ETetheringException

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

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

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

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

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

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

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

関連項目

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