IBCPSession::BCPColumns (OLE DB)

设置要绑定到 SQL Server 表中的列的字段数。

语法

  
HRESULT BCPColumns(   
DBCOUNTITEMnColumns);  

注解

在内部,它调用 IBCPSession::BCPColFmt 来设置字段数据的默认值。 这些默认值是从提供程序内部通过 IBCPSession::BCPInit 指定表名时从内部检索的 SQL Server 列信息获取的。

注释

只有在使用有效的文件名调用 BCPInit 后,才能调用此方法。

仅当你打算使用不同于默认值的用户文件格式时,才应调用此方法。 有关默认用户文件格式的说明的详细信息,请参阅 BCPInit 方法。

调用 BCPColumns 方法后,必须为用户文件中的每一列调用 BCPColFmt 方法才能完全定义自定义文件格式。

论据

nColumns[in]
用户文件中的字段总数。 即使你准备将数据从用户文件批量复制到 SQL Server 表,并且不打算复制用户文件中的所有字段,你仍必须将 nColumns 参数设置为用户文件字段的总数。 然后,可以通过 BCPColFmt 指定跳过的字段。

返回代码值

S_OK
方法成功。

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

E_UNEXPECTED
对方法的调用是意外的。 例如,在调用此方法之前未调用 BCPInit 方法。 对于大容量复制作,多次调用此方法时也会发生。

E_OUTOFMEMORY
内存不足错误。

另请参阅

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