IBCPSession::BCPWriteFmt (OLE DB)

将每列的格式信息写入格式化文件。

语法

  
HRESULT BCPWriteFmt(   
const wchar_t *pwszFormatFile);  

注解

格式化文件指定大容量复制所创建的数据文件的数据格式。 调用 IBCPSession::BCPColumnsIBCPSession::BCPColFmt 方法定义数据文件的格式。 BCPWriteFmt 方法将此定义保存在 pwszFormatFile 参数引用的文件中。

BCPWriteFmt 方法可以采用 xml 或文本格式保存格式化文件。 必须使用带 IBCPSession::BCPControl 方法的 BCP_OPTION_XML 控件选项来指示这一点。

若要加载保存的格式化文件,请使用 IBCPSession::BCPReadFmt 方法。

论据

pwszFormatFile[in]
包含数据文件的格式值的文件的路径和文件名。

返回代码值

S_OK
方法成功。

E_FAIL
发生了提供程序特定的错误;有关详细信息,请使用 ISQLServerErrorInfo 接口。

E_OUTOFMEMORY
内存不足错误。

E_UNEXPECTED
对方法的调用是意外的。 例如,在调用此方法之前,未调用 IBCPSession::BCPInit 方法。

另请参阅

IBCPSession (OLE DB)
执行大容量复制操作