IBCPSession::BCPReadFmt (OLE DB)
Berlaku untuk: 
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
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 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.