IBCPSession::BCPWriteFmt (OLE DB)
將每個資料行的格式資訊寫入格式檔案。
語法
HRESULT BCPWriteFmt(
const wchar_t *pwszFormatFile);
備註
格式檔案會指定大量複製所建立之資料檔的資料格式。IBCPSession::BCPColumns 和 IBCPSession::BCPColFmt 方法的呼叫會定義資料檔的格式。BCPWriteFmt 方法會將此定義儲存在 pwszFormatFile 引數參考的檔案中。
BCPWriteFmt 方法可以用 xml 或文字格式儲存格式檔案。這必須搭配 IBCPSession::BCPControl 方法使用 BCP_OPTION_XML 控制選項指示。
若要載入已儲存的格式檔案，使用 IBCPSession::BCPReadFmt 方法。
[!附註]
只有與 SQL Server 7.0 或更新版本一起散發的 bcp 公用程式版本才支援 BCPWriteFmt 方法所產生的格式檔案。
引數
- pwszFormatFile[in]
包含資料檔格式值之檔案的路徑和檔案名稱。
傳回碼值
S_OK
此方法已成功。E_FAIL
發生提供者特定的錯誤，如需詳細資訊，請使用 ISQLServerErrorInfo 介面。E_OUTOFMEMORY
記憶體不足錯誤。E_UNEXPECTED
呼叫方法是非預期的。例如，在呼叫這個方法之前，不會呼叫 IBCPSession::BCPInit 方法。