Evento EndOfRecordset (ADO)

L'evento EndOfRecordset viene chiamato quando si tenta di passare a una riga oltre la fine del recordset.

Sintassi

  
EndOfRecordset fMoreData, adStatus, pRecordset  

Parametri

fMoreData
Valore VARIANT_BOOL che, se impostato su VARIANT_TRUE, indica che sono state aggiunte più righe al recordset.

adStatus
Valore di stato EventStatusEnum.

Quando viene chiamato EndOfRecordset, questo parametro viene impostato su adStatusOK se l'operazione che ha causato l'evento ha avuto esito positivo. È impostato su adStatusStatusDeny se questo evento non può richiedere l'annullamento dell'operazione che ha causato l'evento.

Prima del termine di EndOfRecordset, impostare questo parametro su adStatusUnwantedEvent per impedire le notifiche successive.

pRecordset
Oggetto Recordset. Recordset per cui si è verificato l'evento.

Commenti

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

Questo gestore eventi viene chiamato quando viene effettuato un tentativo di spostarsi oltre la fine dell'oggetto Recordset, ad esempio come risultato della chiamata a MoveNext. Tuttavia, in questo caso, è possibile recuperare più record da un database e accodarli alla fine del 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 di modello di eventi ADO (VC++)
Riepilogo dei gestori eventi ADO