IBCPSession::BCPColumns (OLE DB)

Berlaku untuk: SQL Server Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform 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 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 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 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