QueryLocator

queryMore() コールで返される QueryResult オブジェクト内の queryLocator には、後続の queryMore() コールで必要な値が含まれています。queryMore() コールでクエリロケータを渡すと、API が QueryResult で新しいクエリロケータ値を返します。この値は、次の queryMore() のコールで使用します。queryLocator は、一度だけ使用します。

親オブジェクトの queryMore() コールは、前の結果セット内のすべての子カーソルを無効にします。子オブジェクトからの結果が必要な場合は、親オブジェクトの結果に queryMore() を使用する前に、子オブジェクトの結果に queryMore() を使用します。

カスタムメタデータクエリを queryLocator として使用することはできません。

クエリロケータが無効な場合、API は障害要素の InvalidQueryLocatorFault と例外の INVALID_QUERY_LOCATOR を返し、さらに起こりうる拡張エラーコードと追加情報を返します。