Compartilhar via


ISSAbort::Abort (OLE DB)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

Baixar o driver do OLE DB

Cancela o conjunto de linhas atual, além de todos os comandos em lote associados ao comando atual.

A interface ISSAbort, que é exposta no OLE DB Driver for SQL Server, fornece o método ISSAbort::Abort que é usado para cancelar o conjunto de linhas atual, além de todos os comandos executados em lotes com o comando que gerou inicialmente o conjunto de linhas e cuja execução ainda não foi concluída.

ISSAbort é uma interface específica do OLE DB Driver for SQL Server disponível por meio do uso de QueryInterface no objeto IMultipleResults retornado por ICommand::Execute ou IOpenRowset::OpenRowset.

Sintaxe

  
HRESULT Abort(void);  

Comentários

Se o comando que está sendo anulado estiver em um procedimento armazenado, a execução dele (e de outros procedimentos que chamaram esse procedimento) será encerrada, bem como o lote de comandos que contém a chamada de procedimento armazenado. Se o servidor estiver no processo de transferir um conjunto de resultados para o cliente, a transferência será interrompida. Se o cliente não quiser consumir um conjunto de resultados, **ISSAbort::Abortbefore releasing the rowset will speed up the rowset release, but if there is an open transaction and XACT_ABORT is ON, the transaction will be rolled back when será chamado

Depois que ISSAbort::Abort retorna S_OK, a interface IMultipleResults associada entra em um estado inutilizável e retorna DB_E_CANCELED para todas as chamadas de método (com exceção dos métodos definidos pela interface IUnknown) até que seja liberada. Se um IRowset foi obtido de IMultipleResults antes de uma chamada para Abort, também entrará em um estado inutilizável e retornará DB_E_CANCELED para todas as chamadas de método (com exceção dos métodos definidos pela interface IUnknown e IRowset::ReleaseRows) até que seja liberado após uma chamada bem-sucedida para ISSAbort::Abort.

Observação

Do SQL Server 2005 (9.x) em diante, se o estado XACT_ABORT do servidor for ON, a execução de ISSAbort::Abort será encerrada e reverterá qualquer transação implícita ou explícita atual quando conectada ao SQL Server. Versões anteriores do SQL Server não anularão a transação atual.

Argumentos

Nenhum.

Valores do código de retorno

S_OK
O método ISSAbort::Abort retorna S_OK se o lote foi cancelado e DB_E_CANTCANCEL em caso contrário. Se o lote já foi cancelado, DB_E_CANCELED será retornado.

DB_E_CANCELED
O lote já foi cancelado.

DB_E_CANTCANCEL
O lote não foi cancelado.

E_FAIL
Um erro específico do provedor ocorreu. Para obter informações detalhadas, use a interface ISQLServerErrorInfo.

E_UNEXPECTED
A chamada para o método era inesperada. Por exemplo, o objeto está em um estado de zumbi porque ISSAbort::Abort já foi chamado.

E_OUTOFMEMORY
Erro de memória insuficiente.