IRowsetFastLoad::Commit (OLE DB)

Şunlar için geçerlidir:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalitik Platform Sistemi (PDW)Microsoft Fabric'te SQL veritabanı

OLE DB sürücüsünü indirme

Eklenen satır grubunun sonunu işaretler ve satırlar SQL Server tablosuna yazar. Örnekler için, IRowsetFastLoad (OLE DB) kullanarak Toplu Veri Kopyalama ve IROWSETFASTLOAD ile ISEQUENTIALSTREAM (OLE DB) kullanarak SQL SERVER'a BLOB Verisi Gönder bkz.

Sözdizimi

  
HRESULT Commit(  
      BOOL fDone);  

Arguments

fDone[in]
YANLIŞ ise, satır kümesi geçerliliğini korur ve tüketici tarafından ek satır ekleme için kullanılabilir. Eğer DOĞRUYSA, satır kümesi geçerliliğini kaybeder ve tüketici tarafından daha fazla ekleme yapılamaz.

Dönüş Kodu Değerleri

S_OK
Yöntem başarılı oldu ve eklenen tüm veriler SQL Server tablosuna yazıldı.

E_FAIL
Sağlayıcıya özgü bir hata meydana geldi. Sağlayıcıdan hata metni için hata bilgisini alın.

E_UNEXPECTED
Yöntem, IRowsetFastLoad::Commit yöntemiyle geçersiz hale getirilen toplu kopyalama satır setinde çağrılmıştır.

Açıklamalar

SQL Server için bir OLE DB Sürücüsü, toplu kopyalama sıralar kümesi, gecikmeli güncelleme modunda bir sıralı küme olarak davranır. Kullanıcı satır seti üzerinden satır verisi eklerken, eklenen satırlar, IRowsetUpdate'i destekleyen bir satır setinde bekleyen eklemelerle aynı şekilde ele alınır.

Tüketici, SQL Server tablosuna eklenmiş satır yazmak için toplu kopyalama satırları sayısındaki Commit yöntemini çağırmalıdır; tıpkı IRowsetUpdate::Update yönteminin bekleyen satırları SQL Server örneğine göndermek için kullanıldığı gibi.

Tüketici, Commit metodunu çağırmadan toplu kopyalama sırası üzerindeki referansını serbest bırakırsa, daha önce yazılmamış tüm eklenen satırlar kaybolur.

Tüketici, fDone argümanı FALSE olarak ayarlanmış Commit metodunu çağırarak eklenmiş satırları toplu olarak çağırabilir. fDoneTRUE olarak ayarlandığında, satır kümesi geçersiz hale gelir. Geçersiz bir toplu kopyalama satır kümesi yalnızca ISupportErrorInfo arayüzü ve IRowsetFastLoad::Release yöntemini destekler.

Ayrıca Bkz.

IRowsetFastLoad (OLE DB)