IRowsetFastLoad::Commit (provider OLE DB Client nativo)

Si applica a: sìSQL Server (tutte le versioni supportate) Sìdatabase SQL di Azure SìIstanza gestita di SQL di Azure sìAzure Synapse Analytics sìParallel Data Warehouse

Contrassegna la fine di un batch di righe inserite e scrive le righe nella tabella di SQL Server. Per gli esempi, vedere Eseguire una copia bulk dei dati usando IRowsetFastLoad (OLE DB) e Inviare dati BLOB a SQL Server usando IROWSETFASTLOAD e ISEQUENTIALSTREAM (OLE DB).

Sintassi

  
HRESULT Commit(  
      BOOL fDone);  

Argomenti

fDone[in]
Se impostato su FALSE, il set di righe resta valido e può essere utilizzato dal consumer per l'inserimento di altre righe. Se impostato su TRUE, il set di righe non è più valido e il consumer non può inserire altre righe.

Valori del codice restituito

S_OK
Il metodo è riuscito e tutti i dati inseriti sono stati scritti nella tabella SQL Server.

E_FAIL
Si è verificato un errore specifico del provider. Recuperare informazioni relative al testo dell'errore specifico dal provider.

E_UNEXPECTED
Il metodo è stato chiamato su un set di righe della copia bulk precedentemente invalidato dal metodo IRowsetFastLoad::Commit.

Osservazioni

Un set di righe OLE DB di copia bulk del provider Native Client si comporta come un set di righe in modalità di aggiornamento SQL Server ritardato. Quando l'utente inserisce dati di riga nel set di righe, le righe inserite vengono gestite analogamente agli inserimenti in sospeso di un set di righe che supporta IRowsetUpdate.

Il consumer deve chiamare il metodo Commit sul set di righe della copia bulk per scrivere le righe inserite nella tabella SQL Server esattamente come quando si usa il metodo IRowsetUpdate::Update per inviare le righe in sospeso a un'istanza di SQL Server.

Se il consumer rilascia il riferimento al set di righe della copia bulk senza chiamare il metodo Commit, tutte le righe inserite e non scritte in precedenza andranno perse.

Il consumer può raggruppare le righe inserite chiamando il metodo Commit con l'argomento fDone impostato su FALSE. Quando fDone è impostato su TRUE, il set di righe non è più valido. Un set di righe della copia bulk non valido supporta solo l'interfaccia ISupportErrorInfo e il metodo IRowsetFastLoad::Release.

Vedere anche

IRowsetFastLoad (OLE DB)