IRowsetFastLoad::Commit (Native Client OLE DB-leverantör)

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Markerar slutet på en batch av insatta rader och skriver raderna till SQL Server-tabellen. För exempel, se Bulk Copy Data Using IRowsetFastLoad (OLE DB) och Send BLOB Data to SQL SERVER Using IROWSETFASTLOAD och ISEQUENTIALSTREAM (OLE DB).

Syntax

  
HRESULT Commit(  
      BOOL fDone);  

Arguments

fDone[in]
Om den är felaktig behåller raduppsättningen sin giltighet och kan användas av konsumenten för ytterligare radinsättning. Om TRUE förlorar raduppsättningen giltighet och ingen ytterligare insättning kan göras av konsumenten.

Returnera kodvärden

S_OK
Metoden lyckades och all inlagd data har skrivits till SQL Server-tabellen.

E_FAIL
Ett leverantörsspecifikt fel inträffade. Hämta felinformation för den specifika feltexten från leverantören.

E_UNEXPECTED
Metoden anropades på en bulkkopia radmängd som tidigare ogiltigförklarats av IRowsetFastLoad:::Commit-metoden .

Remarks

En SQL Server Native Client OLE DB-leverantör bulkkopierar radset som en radmängd i fördröjd uppdateringsläge. När användaren infogar raddata genom raduppsättningen behandlas insatta rader på samma sätt som väntande insättningar på en raduppsättning som stöder IRowsetUpdate.

Konsumenten måste anropa Commit-metoden på bulkkopieringsradsetet för att skriva insatta rader till SQL Server-tabellen på samma sätt som IRowsetUpdate:::Update-metoden används för att skicka väntande rader till en instans av SQL Server.

Om konsumenten släpper sin referens på bulkkopieringsradsetet utan att anropa Commit-metoden , förloras alla insatta rader som inte tidigare skrivits.

Konsumenten kan batch-infogade rader genom att anropa Commit-metoden med fDone-argumentet satt till FALSE. När fDonesätts till TRUE blir raduppsättningen ogiltig. En ogiltig bulkkopia radset stödjer endast ISupportErrorInfo-gränssnittet och IRowsetFastLoad::Release-metoden .

Relaterat innehåll

• IRowsetFastLoad (Native Client OLE DB-leverantör)