| title | ISSAsynchStatus (OLE DB driver) | |
|---|---|---|
| description | Learn how OLE DB Driver for SQL Server uses the ISSAsynchStatus interface to support SQL Server asynchronous operations. | |
| author | David-Engel | |
| ms.author | davidengel | |
| ms.date | 06/14/2018 | |
| ms.service | sql | |
| ms.subservice | connectivity | |
| ms.topic | reference | |
| ms.custom |
|
|
| helpviewer_keywords |
|
|
| apiname | ISSAsynchStatus (OLE DB) | |
| apitype | COM |
[!INCLUDE SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics PDW FabricSQLDB]
[!INCLUDEDriver_OLEDB_Download]
ISSAsynchStatus interface exposes support for [!INCLUDEssNoVersion] asynchronous operations. It is an optional interface that inherits from the core OLE DB interface IDBAsynchStatus. In addition to the Abort and GetStatus methods inherited from IDBAsynchStatus, ISSAsynchStatus provides one new method that is used to wait until an asynchronous operation has completed or a time-out occurs.
| Method | Description |
|---|---|
| ISSAsynchStatus::Abort (OLE DB) | Cancels an asynchronously executing operation. |
| ISSAsynchStatus::GetStatus (OLE DB) | Returns the status of an asynchronously executing operation. |
| ISSAsynchStatus::WaitForAsynchCompletion (OLE DB) | Waits until the asynchronously executing operation is complete or a time-out occurs. |
The ISSAsynchStatus implementation of the ISSAsynchStatus::GetStatus method is the same as the IDBAsynchStatus::GetStatus method except that if the initialization of a data source object is aborted, E_UNEXPECTED is returned rather than DB_E_CANCELED (although ISSAsynchStatus::WaitForAsynchCompletion returns DB_E_CANCELED). It is because the data source object isn't left in the usual state following an abort operation, so that further initialization operations may be attempted.
The following methods support the use of asynchronous execution in [!INCLUDEssNoVersion]:
-
ICommand::Execute
-
IOpenRowset::OpenRowset
-
IMultipleResults::GetResult