IBCPSession::BCPInit (OLE DB)
初始化大容量复制结构，执行某些错误检查，验证数据和格式化文件名是否正确，然后打开文件。
语法
HRESULT BCPInit(
const wchar_t *pwszTable,
const wchar_t *pwszDataFile,
const wchar_t *pwszErrorFile,
int eDirection);
注释
在调用任何其他大容量复制方法之前，应先调用 BCPInit 方法。BCPInit 方法将对工作站和 SQL Server 之间的大容量数据复制执行必要的初始化。
BCPInit 方法将检查数据库源表或目标表的结构，而不检查数据文件。该方法将基于数据库表、视图或 SELECT 结果集中的每一列为数据文件指定数据格式值。此指定包括每一列的数据类型、数据中是否存在长度或 Null 指示符和终止符字节字符串以及固定长度的数据类型的宽度。BCPInit 方法按如下方式设置这些值：
指定的数据类型是数据库表、视图或 SELECT 结果集中的列的数据类型。数据类型由 SQL Server Native Client 头文件 (sqlncli.h) 中指定的 SQL Server 本机数据类型枚举。数据类型的值为 BCP_TYPE_XXX 模式。数据将以其计算机形式表示。也就是说，整数数据类型的列中的数据通过一个由四个字节组成的序列表示，该序列采用 big-endian 或 little-endian 格式，具体使用哪种格式取决于创建该数据文件的计算机。
如果数据库数据类型的长度是固定的，则该数据文件中的数据长度也是固定的。处理数据的大容量复制方法（例如 IBCPSession::BCPExec）将对数据文件中的数据长度预期与数据库表、视图或 SELECT 列列表中指定的数据长度相同的数据行进行分析。例如，对于定义为 char(13) 的数据库列的数据，该文件中每行数据必须由 13 个字符来表示。如果数据库列允许 Null 值，则可以使用 Null 指示符作为固定长度的数据的前缀。
向 SQL Server 复制数据时，数据文件必须包含数据库表中的每列数据。从 SQL Server 复制数据时，数据库表、视图或 SELECT 结果集中所有列的数据均将复制到数据文件。
向 SQL Server 复制数据时，数据文件中列的序号位置必须与数据库表中列的序号位置相同。从 SQL Server 复制数据时，BCPExec 方法将根据数据库表中列的序号位置放置数据。
如果数据库数据类型的长度是可变的（如 varbinary(22)），或者如果数据库列可以包含 Null 值，则在数据文件中使用长度/Null 指示符作为数据的前缀。指示符的宽度因数据类型和大容量复制的版本而异。IBCPSession::BCPControl 方法选项 BCP_OPTION_FILEFMT 通过指示数据中的指示符宽度何时窄于预期宽度，在早期大容量复制数据文件和运行更高版本 SQL Server 的服务器之间提供兼容性。
.gif "注意") 注意 |
|---|
若要更改为数据文件指定的数据格式值，请使用 IBCPSession::BCPColumns 和 IBCPSession::BCPColFmt 方法。 |
对于不包含索引的表，可通过设置数据库选项 select into/bulkcopy 优化对 SQL Server 的大容量复制。
参数
pwszTable[in]
要复制进或复制出的数据库表的名称。该名称可以包含数据库名称或所有者名称。例如，"pubs.username.titles"、"pubs..titles"、"username.titles"。如果 eDirection 参数设置为 BCP_DIRECTION_OUT，则 pwszTable 参数可以为数据库视图的名称。
如果在调用 BCPExec 方法前将 eDirection 参数设置为 BCP_DIRECTION_OUT 并使用 BCPControl 方法指定 SELECT 语句，则必须将 pwszTable 参数设置为 NULL。
pwszDataFile[in]
要复制进或复制出的用户文件的名称。pwszErrorFile[in]
错误文件的名称，该文件将用进度消息、错误消息以及无法从用户文件复制到表的任何行的副本进行填充。如果 pwszErrorFile 参数设置为 NULL，则不使用任何错误文件。eDirection[in]
复制操作的方向，BCP_DIRECTION_IN 或 BCP_DIRECTION _OUT。BCP_DIRECTION _IN 指示从用户文件向数据库表进行复制；BCP_DIRECTION _OUT 指示从数据库表向用户文件进行复制。
返回代码值
S_OK
方法成功。E_FAIL
出现访问特定于接口的错误。要获得详细信息，请使用 ISQLServerErrorInfo 接口。E_OUTOFMEMORY
内存不足错误。E_INVALIDARG
未正确指定一个或多个参数。例如，给定的文件名无效。