IRowsetFastLoad::InsertRow (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

Toplu kopyalama sıra setine bir satır ekler. Ö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 InsertRow(  
      HACCESSOR hAccessor,  
      void* pData);  

Arguments

hAccessor[in]
Toplu kopya için satır verisini tanımlayan accessorun tutamacı. Referans verilen erişimci, veri değerlerini içeren tüketiciye ait belleği bağlayan bir satır accessördür.

pData[in]
Tüketiciye ait belleğe veri değerlerini içeren bir işaretçi. Daha fazla bilgi için DBBINDING Yapıları'na bakınız.

Dönüş Kodu Değerleri

S_OK
Yöntem başarılı oldu. Tüm sütunlar için sınırlı durum değerleri DBSTATUS_S_OK veya DBSTATUS_S_NULL değerine sahiptir.

E_FAIL
Bir hata oluştu. Hata bilgisi, satır kümesinin hata arayüzlerinden erişilebilir.

E_INVALIDARG
pData argümanı NULL işaretçisi olarak ayarlanmıştı.

E_OUTOFMEMORY
MSOLEDBSQL talebi tamamlamak için yeterli bellek ayıramadı.

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

DB_E_BADACCESSORHANDLE
Tüketici tarafından sunulan hAccessor argümanı geçersizdi.

DB_E_BADACCESSORTYPE
Belirtilen erişimci satır erişimci değildi veya tüketiciye ait belleği belirtmiyordu.

Açıklamalar

Bir sütun için tüketici verisini SQL Server veri tipine dönüştürürken yapılan hata, SQL Server için OLE DB Sürücüsünün E_FAIL dönüşüne neden olur. Veriler, herhangi bir InsertRow yöntemiyle veya yalnızca Commit yöntemiyle SQL Server'a iletilebilir. Tüketici uygulaması, bir veri türü dönüşüm hatası olduğunu fark etmeden önce hatalı verilerle InsertRow yöntemini birçok kez çağırabilir. Commit yöntemi, tüm verilerin tüketici tarafından doğru şekilde belirtilmesini sağladığından, tüketici Commit yöntemini uygun şekilde kullanarak verileri doğrulayabilir.

SQL Server için OLE DB Sürücüsü toplu kopyalama satır kümeleri yalnızca yazılabilirdir. SQL Server için OLE DB Sürücüsü, satır kümesini tüketici sorgulamasına izin veren hiçbir yöntemi ortaya çıkarmaz. İşlemeyi sonlandırmak için, tüketici referansını IRowsetFastLoad arayüzünde Commit metodunu çağırmadan serbest bırakabilir. Satır kümesinde tüketici tarafından eklenen bir satıra erişim ve değerlerini değiştirmek ya da satır kümesinden tek tek kaldırmak için hiçbir olanak yoktur.

Toplu kopyalanan satırlar SQL Server için sunucuda biçimlendirilir. Satır formatı, bağlantı veya oturum için ayarlanmış olabilecek seçeneklerden etkilenir, örneğin ANSI_PADDING. Bu seçenek, SQL Server için OLE DB Sürücüsü üzerinden yapılan herhangi bir bağlantı için varsayılan olarak akılıdır.

Ayrıca Bkz.

IRowsetFastLoad (OLE DB)