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

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 penyedia SQL Server Native Client OLE DB 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 salinan massal (bcp) dapat menyimpan format data yang ditentukan pengguna dalam file yang dapat direferensikan oleh metode BCPReadFmt .

Nilai BCP_OPTION_DELAYREADFMT parameter eOption IBCPSession::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