Share via


IRowsetFastLoad::Commit (OLE DB)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform Systeem (PDW)SQL-database in Microsoft Fabric

OLE DB-stuurprogramma downloaden

Markeert het einde van een batch van ingevoegde rijen en schrijft de rijen naar de SQL Server-tabel. Voor voorbeelden, zie Bulk Copy Data Using IRowsetFastLoad (OLE DB) en Send BLOB Data to SQL SERVER met IROWSETFASTLOAD en ISEQUENTIALSTREAM (OLE DB).

Syntaxis

  
HRESULT Commit(  
      BOOL fDone);  

Arguments

fDone[in]
Als het fout is, behoudt de rijset zijn geldigheid en kan door de consument worden gebruikt voor extra rijinvoeging. Als TRUE, verliest de rijset geldigheid en kan de consument geen verdere invoeging meer doen.

Retourcodewaarden

S_OK
De methode is geslaagd en alle ingevoegde gegevens zijn geschreven naar de SQL Server-tabel.

E_FAIL
Er deed zich een zorgverlenerspecifieke fout voor. Haal foutinformatie op voor de specifieke fouttekst van de zorgverlener.

E_UNEXPECTED
De methode werd aangeroepen op een bulk-copy rowset die eerder ongeldig was verklaard door de IRowsetFastLoad::Commit-methode .

Opmerkingen

Een OLE DB-driver voor SQL Server bulk copy rowset gedraagt zich als een delayed-update mode rowset. Terwijl de gebruiker rijgegevens invoegt door de rijset, worden ingevoegde rijen op dezelfde manier behandeld als in afwachting zijnde invoegingen op een rijset die IRowsetUpdate ondersteunt.

De consument moet de Commit-methode aanroepen op de bulk-copy rowset om ingevoegde rijen naar de SQL Server-tabel te schrijven, op dezelfde manier als de IRowsetUpdate::Update-methode wordt gebruikt om wachtende rijen aan een instantie van SQL Server te leveren.

Als de consument zijn referentie op de bulk-copy rowset vrijgeeft zonder de Commit-methode aan te roepen, gaan alle eerder niet geschreven ingevoegde rijen verloren.

De consument kan ingevoegde rijen batchen door de Commit-methode aan te roepen met het fDone-argument op FALSE gezet. Wanneer fDoneop TRUE wordt gezet, wordt de rijset ongeldig. Een ongeldige bulkkopie-rijset ondersteunt alleen de ISupportErrorInfo-interface en de IRowsetFastLoad::Release-methode .

Zie ook

IRowsetFastLoad (OLE DB)