EndOfRecordset イベント (ADO)

  • [アーティクル]

EndOfRecordset イベントは、Recordset の末尾より後の行へ移動しようとすると呼び出されます。

構文

  
EndOfRecordset fMoreData, adStatus, pRecordset

パラメーター

fMoreData
VARIANT_BOOL の値が VARIANT_TRUE に設定されている場合、Recordset にさらに行が追加されたことを示します。

adStatus
EventStatusEnum の状態値。

EndOfRecordset が呼び出されると、イベントの原因となった操作が成功した場合にこのパラメーターは adStatusOK に設定されます。 このイベントがこのイベントの原因となった操作の取り消しを要求できない場合は、adStatusCantDeny に設定されます。

EndOfRecordset が戻る前に、このパラメーターを adStatusUnwantedEvent に設定すると、以降の通知が行われなくなります。

pRecordset
Recordset オブジェクト。 このイベントが発生した Recordset。

注釈

MoveNext 操作が失敗した場合、EndOfRecordset イベントが発生することがあります。

このイベント ハンドラーは、MoveNext を呼び出した結果としてなど、Recordset オブジェクトの末尾より後に移動しようとすると呼び出されます。 ただし、このイベントでは、データベースからさらに多くのレコードを取得して Recordset の末尾に追加できます。 その場合は、fMoreData を VARIANT_TRUE に設定し、EndOfRecordset から戻ります。 次に、MoveNext をもう一度呼び出して、新しく取得したレコードにアクセスします。

参照

ADO イベント モデルの例 (VC++)
ADO イベント ハンドラーの概要