Partilhar via


EndOfRecordset Event (ADO)

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

Sintaxe

  
EndOfRecordset fMoreData, adStatus, pRecordset  

Parâmetros

fMoreData
Um valor VARIANT_BOOL que, se definido como VARIANT_TRUE, indica que mais linhas foram adicionadas ao Conjunto de Registros.

adStatus
Um valor de status EventStatusEnum.

Quando EndOfRecordset é chamado, esse parâmetro é definido como adStatusOK se a operação que causou o evento foi bem-sucedida. Ele será definido como adStatusCantDeny se esse evento não puder solicitar o cancelamento da operação que o causou.

Antes que EndOfRecordset seja retornado, defina esse parâmetro como adStatusUnwantedEvent para evitar as notificações seguintes.

pRecordset
Um objeto Recordset. O Recordset para o qual esse evento ocorreu.

Comentários

Um evento EndOfRecordset poderá ocorrer se a operação MoveNext falhar.

Esse manipulador de eventos é chamado quando uma tentativa é feita para passar o final do objeto Recordset, talvez como resultado da chamada de MoveNext. No entanto, nesse caso, você pode recuperar mais registros de um banco de dados e acrescentá-los ao final do Conjunto de Registros. Nesse caso, defina fMoreData como VARIANT_TRUE e retorne de EndOfRecordset. Em seguida, chame MoveNext novamente para acessar os registros recuperados.

Consulte Também

Exemplo do modelo de eventos ADO (VC++)
Resumo do manipulador de eventos ADO