Bagikan melalui


IRowsetFastLoad::Commit (Penyedia OLE DB Klien Asli)

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Penting

SQL Server Native Client (sering disingkat SNAC) telah dihapus dari SQL Server 2022 (16.x) dan SQL Server Management Studio 19 (SSMS). Penyedia SQL Server Native Client OLE DB (SQLNCLI atau SQLNCLI11) dan Penyedia Microsoft OLE DB warisan untuk SQL Server (SQLOLEDB) tidak direkomendasikan untuk pengembangan baru. Beralih ke Microsoft OLE DB Driver (MSOLEDBSQL) baru untuk SQL Server ke depannya.

Menandai akhir batch baris yang disisipkan dan menulis baris ke tabel SQL Server. Untuk sampel, lihat Menyalin Data Secara Massal Menggunakan IRowsetFastLoad (OLE DB) dan Mengirim Data BLOB ke SQL SERVER Menggunakan IROWSETFASTLOAD dan ISEQUENTIALSTREAM (OLE DB).

Sintaks

  
HRESULT Commit(  
      BOOL fDone);  

Argumen

fDone[in]
Jika FALSE, set baris mempertahankan validitas dan dapat digunakan oleh konsumen untuk penyisipan baris tambahan. Jika TRUE, set baris kehilangan validitas dan tidak ada penyisipan lebih lanjut yang dapat dilakukan oleh konsumen.

Mengembalikan Nilai Kode

S_OK
Metode berhasil dan semua data yang disisipkan telah ditulis ke tabel SQL Server.

E_FAIL
Terjadi kesalahan khusus penyedia. Ambil informasi kesalahan untuk teks kesalahan tertentu dari penyedia.

E_UNEXPECTED
Metode ini dipanggil pada set baris salinan massal yang sebelumnya tidak valid oleh metode IRowsetFastLoad::Commit .

Keterangan

Kumpulan baris salinan massal penyedia SQL Server Native Client OLE DB berperilaku sebagai set baris mode pembaruan tertunda. Saat pengguna menyisipkan data baris melalui set baris, baris yang disisipkan diperlakukan dengan cara yang sama seperti sisipan tertunda pada set baris yang mendukung IRowsetUpdate.

Konsumen harus memanggil metode Penerapan pada set baris salinan massal untuk menulis baris yang disisipkan ke tabel SQL Server dengan cara yang sama seperti metode IRowsetUpdate::Update digunakan untuk mengirimkan baris yang tertunda ke instans SQL Server.

Jika konsumen merilis referensinya pada set baris salinan massal tanpa memanggil metode Penerapan , semua baris yang disisipkan yang sebelumnya tidak ditulis akan hilang.

Konsumen dapat membuat batch baris yang disisipkan dengan memanggil metode Penerapan dengan argumen fDone diatur ke FALSE. Ketika fDonediatur ke TRUE, set baris menjadi tidak valid. Set baris salinan massal yang tidak valid hanya mendukung antarmuka ISupportErrorInfo dan metode IRowsetFastLoad::Release .

Lihat Juga

IRowsetFastLoad (OLE DB)