Evento ExecuteComplete (ADO)

  • Artigo

O evento ExecuteComplete é chamado após a conclusão da execução de um comando.

Sintaxe

ExecuteComplete RecordsAffected, pError, adStatus, pCommand, pRecordset, pConnection

Parâmetros

RecordsAffected
Um valor Long que indica o número de registros afetados pelo comando.

pError
Um objeto Error. Ele descreve o erro ocorrido se o valor de adStatus é adStatusErrorsOccurred, caso contrário, ele não é definido.

adStatus
Um valor de status EventStatusEnum. Quando esse evento é chamado, esse parâmetro é definido como adStatusOK se a operação que causou o evento foi bem-sucedida ou como adStatusErrorsOccurred se a operação falhou.

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

pCommand
O objeto Command que foi executado. Contém um objeto Command mesmo com uma chamada a Connection.Execute ou a Recordset.Open sem a criação explícita de um Command, em cujos casos o objeto Command é criado internamente pelo ADO.

pRecordset
Um objeto Recordset que é o resultado do comando executado. Esse Recordset pode estar vazio. Você nunca deve destruir esse objeto Recordset nesse manipulador de eventos. Isso resultará em uma Violação de Acesso quando o ADO tentar acessar um objeto que não existe mais.

pConnection
Um objeto Connection. A conexão na qual a operação foi executada.

Comentários

Um evento ExecuteComplete pode ocorrer devido aos métodos Connection.Execute, Command.Execute, Recordset.Open, Recordset.Requery ou Recordset.NextRecordset.

Consulte Também

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