EndOfRecordset イベント (ADO)EndOfRecordset Event (ADO)

EndOfRecordsetイベントが呼び出されるは、行の末尾に移動する試みがあるときに、 Recordsetします。The EndOfRecordset event is called when there is an attempt to move to a row past the end of the Recordset.

構文Syntax

  
EndOfRecordset fMoreData, adStatus, pRecordset  

パラメーターParameters

fMoreDatafMoreData
A VARIANT_BOOL値を VARIANT_TRUE に設定、複数の行に追加されたことを示します、 Recordsetします。A VARIANT_BOOL value that, if set to VARIANT_TRUE, indicates more rows have been added to the Recordset.

adStatusadStatus
EventStatusEnum状態値。An EventStatusEnum status value.

ときにEndOfRecordsetが呼び出されると、このパラメーターを設定adStatusOKイベントの原因となった操作が成功した場合。When EndOfRecordset is called, this parameter is set to adStatusOK if the operation that caused the event was successful. 設定されているadStatusCantDeny場合、このイベントは、このイベントの原因となった操作のキャンセルを要求できません。It is set to adStatusCantDeny if this event cannot request cancellation of the operation that caused this event.

前にEndOfRecordset戻り値は、このパラメーターに設定するadStatusUnwantedEvent後続通知しないように設定します。Before EndOfRecordset returns, set this parameter to adStatusUnwantedEvent to prevent subsequent notifications.

pRecordsetpRecordset
A Recordsetオブジェクト。A Recordset object. Recordsetのこのイベントが発生しました。The Recordset for which this event occurred.

コメントRemarks

EndOfRecordset場合に、イベントが発生する可能性があります、 MoveNext操作は失敗します。An EndOfRecordset event may occur if the MoveNext operation fails.

末尾を越えた移動を試行したときに、このイベント ハンドラーが呼び出されます、 Recordset呼び出しの結果などのオブジェクトMoveNextします。This event handler is called when an attempt is made to move past the end of the Recordset object, perhaps as a result of calling MoveNext. ただし、このイベント中にデータベースから複数のレコードを取得してそれらの末尾に追加、 Recordsetします。However, while in this event, you could retrieve more records from a database and append them to the end of the Recordset. この場合は、 fMoreData 、VARIANT_TRUE とからの戻り値にEndOfRecordsetします。In that case, set fMoreData to VARIANT_TRUE, and return from EndOfRecordset. 呼び出してMoveNext新しく取得したレコードにアクセスするには、もう一度です。Then call MoveNext again to access the newly retrieved records.

関連項目See Also

ADO イベント モデルの例 (vc++) ADO Events Model Example (VC++)
ADO イベント ハンドラーの概要ADO Event Handler Summary