IRowsetFastLoad::Commit (OLE DB)
Contrassegna la fine di un batch di righe inserite e scrive le righe nella tabella di SQL Server. Per alcuni esempi, vedere Eseguire una copia bulk di dati mediante IRowsetFastLoad (OLE DB) e Inviare dati BLOB a SQL Server utilizzando 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 di codice restituiti
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 della copia bulk del provider OLE DB di SQL Server Native Client si comporta come un set di righe in modalità di aggiornamento 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 utilizza 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.