IRowsetFastLoad::InsertRow (OLE DB)

Berlaku untuk: SQL Server Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Unduh driver OLE DB

Menambahkan baris ke kumpulan baris salinan massal. 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 InsertRow(  
      HACCESSOR hAccessor,  
      void* pData);  

Argumen

hAccessor[in]
Handel aksesor yang menentukan data baris untuk salinan massal. Pengaktif yang direferensikan adalah pengaktif baris, mengikat memori milik konsumen yang berisi nilai data.

pData[in]
Penunjuk ke memori milik konsumen yang berisi nilai data. Untuk informasi selengkapnya, lihat Struktur DBBINDING.

Mengembalikan Nilai Kode

S_OK
Metode berhasil. Nilai status terikat apa pun untuk semua kolom memiliki nilai DBSTATUS_S_OK atau DBSTATUS_S_NULL.

E_FAIL
Terjadi kesalahan. Informasi kesalahan tersedia dari antarmuka kesalahan set baris.

E_INVALIDARG
Argumen pData diatur ke penunjuk NULL.

E_OUTOFMEMORY
MSOLEDBSQL tidak dapat mengalokasikan memori yang cukup untuk menyelesaikan permintaan.

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

DB_E_BADACCESSORHANDLE
Argumen hAccessor yang disediakan oleh konsumen tidak valid.

DB_E_BADACCESSORTYPE
Pengaktif yang ditentukan bukan pengaktif baris atau tidak menentukan memori milik konsumen.

Keterangan

Kesalahan saat mengonversi data konsumen ke jenis data SQL Server untuk kolom menyebabkan pengembalian E_FAIL dari Driver OLE DB untuk SQL Server. Data dapat dikirimkan ke SQL Server pada metode InsertRow apa pun atau hanya pada metode Penerapan. Aplikasi konsumen dapat memanggil metode InsertRow berkali-kali dengan data yang salah sebelum menerima pemberitahuan bahwa ada kesalahan konversi jenis data. Karena metode Penerapan memastikan bahwa semua data ditentukan dengan benar oleh konsumen, konsumen dapat menggunakan metode Penerapan dengan tepat untuk memvalidasi data seperlunya.

Driver OLE DB untuk set baris salinan massal SQL Server hanya untuk penulisan. Driver OLE DB untuk SQL Server tidak mengekspos metode yang memungkinkan kueri konsumen dari set baris. Untuk mengakhiri pemrosesan, konsumen dapat merilis referensinya pada antarmuka IRowsetFastLoad tanpa memanggil metode Penerapan . Tidak ada fasilitas untuk mengakses baris yang disisipkan konsumen di kumpulan baris dan mengubah nilainya, atau menghapusnya satu per satu dari set baris.

Baris yang disalin secara massal diformat di server untuk SQL Server. Format baris dipengaruhi oleh opsi apa pun yang mungkin telah diatur untuk koneksi atau sesi seperti ANSI_PADDING. Opsi ini diatur secara default untuk koneksi apa pun yang dibuat melalui Driver OLE DB untuk SQL Server.

Lihat juga

IRowsetFastLoad (OLE DB)