前のトピック: doSelect次のトピック: getListValues


doQuery

doQuery メソッドでは、以下のパラメータを使用します。

パラメータ

タイプ

説明

SID

整数

ログインにより取得したセッションを指定します。

ObjectType

文字列

クエリするオブジェクト タイプ(ファクトリ)を指定します。

WhereClause

文字列

(オプション)クエリのWhere節を指定します。

説明

指定したオブジェクト タイプに対して SQL に似た選択操作が実行されます。 また、クエリによって返された行のリストを指すリスト ハンドルも返されます。各行は、指定した Where 節に一致した CA SDM オブジェクトを表しています。 コール元は getListValues() を使用してリストの行の値をフェッチできます。

注: Where 節の詳細については、「Where 節」を参照してください。

重要: オブジェクト リストは CA SDM サーバに保存され、システムのリソースを消費します。 コール元は、freeListHandles() でリストを解放する必要があります。 メモリ内にリストが残っていると、プロセスに対するメモリが増加して 2 GB の制限を超過し、メモリ リークが発生して、システム障害を引き起こす可能性があります。

この関数によって作成されたリストは均質です。つまり、オブジェクトはすべて同じタイプで、静的です。したがって、オブジェクトに対するデータ変更によって、最初の Where 節に一致しなくなった場合でも、リストは変更されません。

戻り値

freeListHandle() で解放する必要のあるリスト ハンドル。

XML エレメント

タイプ

説明

<listHandle>

整数

リスト ハンドルを示します。

<listLength>

整数

生成されたリストの長さを示します。