Partilhar via


Evento EndOfRecordset (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 Recordset.

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 causou esse evento.

Antes que EndOfRecordset retorne, defina esse parâmetro como adStatusUnwantedEvent para evitar notificações subsequentes.

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

Observações

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

Esse manipulador de eventos é chamado quando é feita uma tentativa de passar do final do objeto Recordset, talvez como resultado da chamada MoveNext. No entanto, nesse caso, você pode recuperar mais registros de um banco de dados e anexá-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 recém-recuperados.

Consulte Também

exemplo de modelo de eventos do ADO (VC++)
resumo do manipulador de eventos do ADO