Partilhar via

Evento ExecuteComplete (ADO)

  • Artigo

O evento ExecuteComplete é chamado após a 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 que ocorreu se o valor de adStatus for adStatusErrorsOccurred; caso contrário, não está 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 adStatusErrorsOccurred se a operação falhou.

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

pCommand
O objeto command que foi executado. Contém um objeto de Comando mesmo ao chamar Connection.Execute ou Recordset.Open sem criar explicitamente um de Comando, nesse caso, o objeto de Comando é criado internamente pelo ADO.

pRecordset
Um recordset objeto que é o resultado do comando executado. Esta do Conjunto de Registros pode estar vazia. Você nunca deve destruir esse objeto Recordset de dentro desse 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 de Conexão. A conexão sobre a qual a operação foi executada.

Observações

Um evento ExecuteComplete pode ocorrer devido à conexão .Executar, comando .Execute, Recordset.Open, Recordset.Requery ou Recordset.métodos NextRecordset.

Consulte Também

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