IBCPSession::BCPColumns (OLE DB)

Berlaku untuk: SQL Server (semua versi yang didukung) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Unduh driver OLE DB

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

Sintaks

  
HRESULT BCPColumns(   
      DBCOUNTITEM nColumns);  

Keterangan

Secara internal memanggil IBCPSession::BCPColFmt untuk mengatur nilai default untuk data bidang. Nilai default ini diperoleh dari SQL Server informasi kolom 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 berniat 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 ini tidak terduga. Misalnya, metode BCPInit tidak dipanggil sebelum memanggil metode ini. Juga terjadi ketika metode ini dipanggil lebih dari sekali untuk operasi penyalinan massal.

E_OUTOFMEMORY
Kesalahan kehabisan memori.

Lihat juga

IBCPSession (OLE DB)
Melakukan Operasi Salin Massal