REST.Backend.EMSApi.TEMSClientAPI.QueryResource

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

Delphi

procedure QueryResource(const AResource: string;  const AQuery: array of string; const AJSONArray: TJSONArray; AReset: Boolean; const AAddParameters: TProc = nil);

C++

void __fastcall QueryResource(const System::UnicodeString AResource, const System::UnicodeString *AQuery, const int AQuery_High, System::Json::TJSONArray* const AJSONArray, bool AReset, const System::Sysutils::_di_TProc AAddParameters = System::Sysutils::_di_TProc());

プロパティ

種類 可視性 ソース ユニット
procedure
function
protected
REST.Backend.EMSApi.pas
REST.Backend.EMSApi.hpp
REST.Backend.EMSApi TEMSClientAPI


説明

指定されたリソース タイプのリソースのリストを EMS サーバーに問い合わせます。

QueryResource が受け取るパラメータは次のとおりです。

  • AResource対象となるリソース タイプです。
  • AQuery: 等号で区切られたキーと値のペアの文字列(たとえば、"my_parameter=my_value" など)を要素とする文字列配列です。QueryResource では、これらのキー/値ペアをパラメータとして要求に追加します。
  • AJSONArrayQueryResource で EMS サーバーから取得された結果の格納先です。
  • AResetQueryResource で要求パラメータをリセットするか(True)、それとも、前回の要求のパラメータを基に新しい要求を作成するか(False)を指定します。

    たとえば、パラメータが同じで対象リソースだけが異なる問い合わせを 1 つの行で数回実行する場合は、AReset として False を渡してパフォーマンスを向上させることができます。

例外

例外 メッセージ 説明

EEMSClientAPIError

MasterSecret が必要です

AuthenticationTAuthentication.MasterSecret で、ConnectionInfo.MasterSecret が空の文字列になっています。

セッション トークンが必要です

AuthenticationTAuthentication.Session で、かつ、ログインが行われなかったか、Login の呼び出し時に渡されたセッション認証トークンが空の文字列になっています。

関連項目