IBCPSession::BCPWriteFmt (Penyedia OLE DB Klien Asli)

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

Menulis informasi format untuk setiap kolom ke file format.

Sintaks

  
HRESULT BCPWriteFmt(   
      const wchar_t *pwszFormatFile);  

Keterangan

File format menentukan format data file data yang dibuat oleh salinan massal. Panggilan ke metode IBCPSession::BCPColumns dan IBCPSession::BCPColFmt menentukan format file data. Metode BCPWriteFmt menyimpan definisi ini dalam file yang dirujuk oleh argumen pwszFormatFile.

Metode BCPWriteFmt dapat menyimpan file format dalam format xml atau teks. Ini harus ditunjukkan dengan menggunakan opsi kontrol BCP_OPTION_XML dengan metode IBCPSession::BCPControl .

Untuk memuat file format yang disimpan, gunakan metode 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