Evento EndOfRecordset (ADO)

L'evento EndOfRecordset viene chiamato quando si prova a passare a una riga successiva alla fine dell'oggetto Recordset.

Sintassi

  
EndOfRecordset fMoreData, adStatus, pRecordset  

Parametri

fMoreData
Valore VARIANT_BOOL che, se impostato su VARIANT_TRUE, indica che sono state aggiunte più righe all'oggetto Recordset.

adStatus
Valore di stato EventStatusEnum.

Quando viene chiamato EndOfRecordset, questo parametro viene impostato su adStatusOK se l'operazione che ha generato l'evento è riuscita. È impostato su adStatusCantDeny se questo evento non può richiedere l'annullamento dell'operazione che ha generato questo evento.

Prima che venga restituito EndOfRecordset, impostare questo parametro su adStatusUnwantedEvent per impedire le notifiche successive.

pRecordset
Oggetto Recordset. Recordset per cui si è verificato questo evento.

Osservazioni

Se l'operazione MoveNext non riesce, può verificarsi un evento EndOfRecordset.

Questo gestore eventi viene chiamato quando si effettua un tentativo di spostamento oltre la fine dell'oggetto Recordset, ad esempio in seguito alla chiamata a MoveNext. Tuttavia, in questo caso, è possibile recuperare più record da un database e accodarli alla fine dell'oggetto Recordset. In tal caso, impostare fMoreData su VARIANT_TRUE e restituire da EndOfRecordset. Chiamare quindi di nuovo MoveNext per accedere ai record appena recuperati.

Vedere anche

Esempio del modello di eventi ADO (VC++)
Riepilogo dei gestori eventi ADO