IBCPSession::BCPReadFmt (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

Membaca informasi format untuk setiap kolom dari file format.

Sintaks

  
HRESULT BCPReadFmt(   
      const wchar_t *pwszFormatFile);  

Keterangan

Metode BCPReadFmt digunakan untuk membaca data dari file format yang menentukan format data dalam file data. Metode ini mampu mendeteksi versi file format yang benar. Ini dapat secara otomatis mendeteksi apakah file format dalam format teks xml atau gaya lama dan bertindak sesuai. Versi file format yang didukung oleh Driver OLE DB untuk SQL Server BCP adalah versi 6.0 atau yang lebih baru.

Setelah metode BCPReadFmt membaca nilai format, metode ini melakukan panggilan yang sesuai ke metode IBCPSession::BCPColumns dan IBCPSession::BCPColFmt . Pengguna tidak perlu mengurai file format dan melakukan panggilan ini.

Untuk menyimpan file format, panggil metode IBCPSession::BCPWriteFmt . Panggilan ke metode BCPReadFmt dapat mereferensikan format yang disimpan. Atau, utilitas salin massal (bcp) dapat menyimpan format data yang ditentukan pengguna dalam file yang dapat direferensikan oleh metode BCPReadFmt .

Nilai BCP_OPTION_DELAYREADFMT parameter eOptionIBCPSession::BCPControl memodifikasi perilaku IBCPSession::BCPReadFmt.

Argumen

pwszFormatFile[in]
Jalur dan nama file file yang berisi nilai format untuk file data.

Mengembalikan Nilai Kode

S_OK
Metode berhasil.

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

E_OUTOFMEMORY
Kesalahan kehabisan memori.

E_UNEXPECTED
Panggilan ke metode tidak terduga. Misalnya, metode IBCPSession::BCPInit tidak dipanggil sebelum memanggil metode ini.

Lihat juga

IBCPSession (OLE DB)
Melakukan Operasi Salin Massal