ISSAsynchStatus (OLE DB)

 

System_CAPS_ICON_warning.jpg Warning

SQL Server Native Client (SNAC) is not supported beyond SQL Server 2012. Avoid using SNAC in new development work, and plan to modify applications that currently use it. The Microsoft ODBC Driver for SQL Server provides native connectivity from Windows to Microsoft SQL Server and Microsoft Azure SQL Database.

ISSAsynchStatus exposes support for SQL Server asynchronous operations. This 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.

MethodDescription
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). This is because the data source object is not 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 SQL Server:

  • ICommand::Execute

  • IOpenRowset::OpenRowset

  • IMultipleResults::GetResult

Interfaces (OLE DB)
Performing Asynchronous Operations

Community Additions

ADD
Show: