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

Menambahkan baris ke himpunan baris salin 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. Aksesor 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
SQLNCLI11 tidak dapat mengalokasikan memori yang cukup untuk menyelesaikan permintaan.

E_UNEXPECTED
Metode ini dipanggil pada set 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
Aksesor 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 penyedia SQL Server Native Client OLE DB. Data dapat ditransmisikan 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.

Kumpulan baris salinan massal penyedia SQL Server Native Client OLE DB bersifat tulis-saja. Penyedia SQL Server Native Client OLE DB tidak mengekspos metode yang memungkinkan kueri konsumen dari set baris. Untuk mengakhiri pemrosesan, konsumen dapat merilis referensinya pada antarmuka IRowsetFastLoad tanpa memanggil metode Commit . Tidak ada fasilitas untuk mengakses baris yang disisipkan konsumen di set 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 penyedia SQL Server Native Client OLE DB.

Lihat Juga

IRowsetFastLoad (OLE DB)