ISSAsynchStatus::WaitForAsynchCompletion in SQL Server Native Client (OLE DB)
Si applica a:
SQL Server database SQL di Azure Istanza gestita di SQL di Azure azure Synapse Analytics Analytics Platform System (PDW)
Importante
SQL Server Native Client (spesso abbreviato SNAC) è stato rimosso da SQL Server 2022 (16.x) e da SQL Server Management Studio 19 (SSMS). Il provider OLE DB di SQL Server Native Client (SQLNCLI o SQLNCLI11) e il provider OLE DB legacy Microsoft per SQL Server (SQLOLEDB) non sono consigliati per lo sviluppo di nuove applicazioni. In futuro, passare al nuovo driver Microsoft OLE DB (MSOLEDBSQL) per SQL Server.
Resta in attesa fino al completamento dell'operazione di esecuzione asincrona o fino al verificarsi di un timeout.
Sintassi
HRESULT WaitForAsynchCompletion(
DWORD dwMillisecTimeOut);
Argomenti
dwMillisecTimeOut[in]
Timeout in millisecondi.
Valori del codice restituito
S_OK
Il metodo è riuscito.
E_UNEXPECTED
Un set di righe è in uno stato inutilizzato perché ITransaction::Commit o ITransaction::Abort è stato chiamato o il set di righe è stato annullato durante la fase di inizializzazione.
DB_E_CANCELED
L'elaborazione asincrona è stata annullata durante il popolamento del set di righe o l'inizializzazione dell'oggetto origine dati.
DB_S_ASYNCHRONOUS
L'operazione non è stata ancora completata anche se è stato raggiunto il timeout specificato.
Nota
Oltre ai valori di codice restituiti elencati in precedenza, il metodo ISSAsynchStatus::WaitForAsynchCompletion supporta anche i valori di codice restituiti dai metodi OLEDB di base ICommand::Execute e IDBInitialize::Initialize.
Osservazioni:
Il metodo ISSAsynchStatus::WaitForAsynchCompletion non verrà restituito fino al superamento del valore di timeout (in millisecondi) o al completamento dell'operazione in sospeso. L'oggetto Command ha una proprietà CommandTimeout che controlla il numero di secondi di esecuzione di una query prima del timeout . La proprietà CommandTimeout verrà ignorata se utilizzata insieme al metodo ISSAsynchStatus::WaitForAsynchCompletion .
La proprietà di timeout viene ignorata per le operazioni asincrone. Il parametro di timeout di ISSAsynchStatus::WaitForAsynchCompletion specifica la quantità massima di tempo che deve trascorrere prima che il controllo venga restituito al chiamante. Se questo timeout scade, verrà restituito DB_S_ASYNCHRONOUS. I timeout non annullano mai operazioni asincrone. Se l'applicazione deve annullare un'operazione asincrona che non viene completata entro il periodo di timeout, deve attendere lo scadere del timeout e quindi annullare in modo esplicito l'operazione se viene restituito DB_S_ASYNCHRONOUS.
Nota
Quando si usano i componenti del servizio OLE DB, è possibile che venga restituito S_OK quando è previsto DB_S_ASYNCHRONOUS. Quando viene restituito S_OK o DB_S_ASYNCHRONOUS, le applicazioni devono pertanto chiamare ISSAsynchStatus::GetStatus per verificare il completamento.
Se il valore di dwMillisecTimeOut è impostato su INFINITE, il metodo ISSAsynchStatus::WaitForAsynchCompletion mantiene il blocco fino al completamento dell'operazione. Se il valore di dwMillisecTimeOut è impostato su 0, il metodo restituirà immediatamente lo stato dell'operazione in sospeso. Se il timeout scade prima del completamento dell'operazione, viene restituito DB_S_ASYNCHRONOUS.
Se l'operazione viene completata prima dello scadere del timeout, il valore HRESULT restituito sarà quello restituito dall'operazione, ovvero il valore HRESULT che sarebbe stato restituito se l'operazione fosse stata eseguita in modo sincrono.
È stata inoltre aggiunta la proprietà SSPROP_ISSAsynchStatus al set di proprietà DBPROPSET_SQLSERVERROWSET. I provider che supportano l'interfaccia ISSAsynchStatus devono implementare questa proprietà con un valore VARIANT_TRUE.