Bagikan melalui


IBCPSession::BCPColumns (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.

Mengatur jumlah bidang yang akan terikat ke kolom dalam tabel SQL Server.

Sintaks

  
HRESULT BCPColumns(   
      DBCOUNTITEM nColumns);  

Keterangan

Secara internal, ia memanggil IBCPSession::BCPColFmt untuk mengatur nilai default untuk data bidang. Nilai default ini diperoleh dari informasi kolom SQL Server yang diambil penyedia secara internal ketika nama tabel ditentukan melalui IBCPSession::BCPInit.

Catatan

Metode ini hanya dapat dipanggil setelah BCPInit dipanggil dengan nama file yang valid.

Anda harus memanggil metode ini hanya jika Anda ingin menggunakan format file pengguna yang berbeda dari default. Untuk informasi selengkapnya tentang deskripsi format file pengguna default, lihat metode BCPInit .

Setelah memanggil metode BCPColumns , Anda harus memanggil metode BCPColFmt untuk setiap kolom dalam file pengguna untuk sepenuhnya menentukan format file kustom.

Argumen

nColumns[in]
Jumlah total bidang dalam file pengguna. Bahkan jika Anda bersiap untuk menyalin data secara massal dari file pengguna ke tabel SQL Server dan tidak berniat menyalin semua bidang dalam file pengguna, Anda masih harus mengatur argumen nColumns ke jumlah total bidang file pengguna. Bidang yang dilewati kemudian dapat ditentukan melalui BCPColFmt.

Mengembalikan Nilai Kode

S_OK
Metode berhasil.

E_FAIL
Terjadi kesalahan khusus penyedia; untuk informasi terperinci, gunakan antarmuka ISQLServerErrorInfo .

E_UNEXPECTED
Panggilan ke metode tidak terduga. Misalnya, metode BCPInit tidak dipanggil sebelum memanggil metode ini. Juga terjadi ketika metode ini disebut lebih dari sekali untuk operasi penyalinan massal.

E_OUTOFMEMORY
Kesalahan kehabisan memori.

Lihat Juga

IBCPSession (OLE DB)
Melakukan Operasi Salin Massal