| title | description | author | ms.author | ms.date | ms.service | ms.subservice | ms.topic | helpviewer_keywords | apiname | apitype | |
|---|---|---|---|---|---|---|---|---|---|---|---|
ISSAbort::Abort (Native Client OLE DB provider) |
ISSAbort::Abort (Native Client OLE DB provider) |
markingmyname |
maghan |
03/14/2017 |
sql |
native-client |
reference |
|
ISSAbort::Abort (OLE DB) |
COM |
[!INCLUDESQL Server Azure SQL Database Synapse Analytics PDW]
Important
[!INCLUDEsnac-removed-oledb-only]
Cancels the current rowset plus any batched commands associated with the current command.
The ISSAbort interface, which is exposed in the [!INCLUDEssNoVersion] Native Client OLE DB provider, provides the ISSAbort::Abort method that is used to cancel the current rowset plus any commands batched with the command that initially generated the rowset, and that have not yet completed execution.
ISSAbort is a [!INCLUDEssNoVersion] Native Client provider-specific interface available by using QueryInterface on the IMultipleResults object returned by ICommand::Execute or IOpenRowset::OpenRowset.
HRESULT Abort(void);
If the command being aborted is in a stored procedure, execution of the stored procedure (and any procedures that had called that procedure) will be terminated as well as the command batch that contains the stored procedure call. If the server is in the process of transferring a result set to the client, this will be stopped. If the client does not want to consume a result set, calling ISSAbort::Abort before 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 ISSAbort::Abort is called
After ISSAbort::Abort returns S_OK, the associated IMultipleResults interface enters an unusable state and returns DB_E_CANCELED to all method calls (except for methods defined by the IUnknown interface) until it is released. If an IRowset had been obtained from IMultipleResults prior to a call to Abort, it also enters an unusable state and returns DB_E_CANCELED to all method calls (except for methods defined by the IUnknown interface and IRowset::ReleaseRows) until it is released after a successful call to ISSAbort::Abort.
Note
Beginning with [!INCLUDEssVersion2005], if the server XACT_ABORT state is ON, executing ISSAbort::Abort will terminate and roll back any current implicit or explicit transaction when connected to [!INCLUDEssNoVersion]. Earlier versions of [!INCLUDEssNoVersion] will not abort the current transaction.
None.
S_OK
The ISSAbort::Abort method returns S_OK if the batch was canceled and DB_E_CANTCANCEL otherwise. If the batch has already been canceled, DB_E_CANCELED is returned.
DB_E_CANCELED
The batch has already been canceled.
DB_E_CANTCANCEL
The batch was not canceled.
E_FAIL
A provider-specific error occurred; for detailed information, use the ISQLServerErrorInfo interface.
E_UNEXPECTED
The call to the method was unexpected. For example, the object is in a zombie state because ISSAbort::Abort has already been called.
E_OUTOFMEMORY
Out of memory error.