ISSAsynchStatus (Fornecedor Nativo de Cliente OLE DB)

Aplica-se a: SQL ServerBase de Dados SQL do AzureAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)

Importante

O SQL Server Native Client (geralmente abreviado SNAC) foi removido do SQL Server 2022 (16.x) e do SQL Server Management Studio 19 (SSMS). O provedor OLE DB do SQL Server Native Client (SQLNCLI ou SQLNCLI11) e o provedor Microsoft OLE DB herdado para SQL Server (SQLOLEDB) não são recomendados para novos desenvolvimentos. Mude para o novo Microsoft OLE DB Driver (MSOLEDBSQL) para SQL Server daqui em diante.

O ISSAsynchStatus expõe suporte para operações assíncronas no SQL Server. Esta é uma interface opcional que herda da interface principal do OLE DB IDBAsynchStatus. Para além dos métodos Abort e GetStatus herdados do IDBAsynchStatus, o ISSAsynchStatus fornece um novo método que é usado para esperar até que uma operação assíncrona seja concluída ou ocorra um time-out.

Método Description
ISSAsynchStatus::Abort (OLE DB) Cancela uma operação em execução assíncrona.
ISSAsynchStatus::GetStatus (OLE DB) Devolve o estado de uma operação em execução assíncrona.
ISSAsynchStatus::WaitForAsynchCompletion (OLE DB) Espera até que a operação em execução assíncrona seja concluída ou ocorra um time-out.

Observações

A implementação ISSAsynchStatus do método ISSAsynchStatus::GetStatus é igual ao método IDBAsynchStatus::GetStatus , exceto que, se a inicialização de um objeto fonte de dados for abortada, E_UNEXPECTED é devolvido em vez de DB_E_CANCELED (embora ISSAsynchStatus::WaitForAsynchCompletion devolva DB_E_CANCELED). Isto porque o objeto fonte de dados não fica no estado habitual após uma operação de aborto, permitindo que operações de inicialização adicionais possam ser tentadas.

Os seguintes métodos suportam a utilização de execução assíncrona no SQL Server:

  • ICommand::Executar

  • IOpenRowset::OpenRowSet

  • IMultipleResultados::ObtenerResultado.