设置要绑定到 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
内存不足错误。