ClusterRegReadBatchReplyNextCommand 関数 (clusapi.h)

読み取りバッチ結果から次のコマンドを読み取ります。

構文

LONG ClusterRegReadBatchReplyNextCommand(
  [in]  HREGREADBATCHREPLY         hRegReadBatchReply,
  [out] CLUSTER_READ_BATCH_COMMAND *pBatchCommand
);

[in] hRegReadBatchReply

ClusterRegCloseReadBatch 関数を呼び出して作成された読み取りバッチ結果へのハンドル。このハンドルは、後で ClusterRegCloseReadBatchReply 関数を呼び出して閉じる必要があります。

[out] pBatchCommand

読み取りコマンドに関する情報を含む CLUSTER_READ_BATCH_COMMAND 構造体へのポインター。

関数は、次のいずれかのシステムエラーコードを返します。

リターンコード/値	Description
ERROR_SUCCESS 0	操作に成功しました。
ERROR_INVALID_HANDLE 6	hRegReadBatchReply が NULL であるか、無効です。
ERROR_NO_MORE_ITEMS 259	hRegReadBatchReply にこれ以上の情報はありません。

読み取りバッチ結果のレコード数は、読み取りバッチ内のコマンドの数と同じです。また、結果は、読み取りバッチに追加されたコマンドと同じ順序になります。