Evento EndOfRecordset (ADO)

Aplica-se ao: Access 2013, Office 2013

O evento EndOfRecordset é chamado quando houver uma tentativa de mover para uma linha após o final do Recordset.

Sintaxe

EndOfRecordsetfMoreData, adStatus, pRecordset

Parâmetros

Parâmetro	Descrição
fMoreData	Um valor VARIANT_BOOL que, se definido como VARIANT_TRUE, indica que mais linhas linhas foram incluídas no Recordset.
adStatus	EventStatusEnum. Quando EndOfRecordset for chamado, esse parâmetro será definido como adStatusOK se a operação que provocou o evento tiver sido bem-sucedida. Será definido como adStatusCantDeny se esse evento não puder solicitar o cancelamento da operação que provocou esse evento. Antes que EndOfRecordset seja retornado, configure esse parâmetro como adStatusUnwantedEvent para impedir as notificações subsequentes.
pRecordset	Um objeto Recordset. O Recordset para o qual esse evento ocorreu.

Comentários

Pode ocorrer um evento EndOfRecordset se a operação MoveNext falhar.

Esse manipulador eventos é chamada quando é feita uma tentativa de mover após o final do objeto Recordset, talvez como resultado de chamar MoveNext. No entanto, enquanto estiver nesse evento, você poderia recuperar mais registros de um banco de dados e anexá-los final do Recordset. Nesse caso, defina fMoreData como VARIANT_TRUE e retorne de EndOfRecordset. Em seguida, chame MoveNext novamente para acessar os registros recém-recuperados.