IBCPSession::BCPColumns (OLE DB)
Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)
Задает количество полей, привязанных к столбцам в таблице SQL Server.
Синтаксис
HRESULT BCPColumns(
DBCOUNTITEM nColumns);
Замечания
Этот метод совершает внутренний вызов метода IBCPSession::BCPColFmt для установки значений по умолчанию для полей данных. Эти значения по умолчанию получаются из информации о столбце SQL Server, которую внутренним образом возвращает поставщик, когда имя таблицы указывается через IBCPSession::BCPInit.
Примечание.
Данный метод можно вызывать только после того, как вызван метод BCPInit с допустимым именем файла.
Этот метод следует вызывать только в случае, когда планируется использовать нестандартный формат пользовательского файла. Дополнительную информацию об описании стандартного формата пользовательского файла см. в справке по методу BCPInit .
После вызова метода BCPColumns следует вызвать метод BCPColFmt для каждого столбца в пользовательском файле, чтобы полностью описать нестандартный формат файла.
Аргументы
nColumns[in]
Общее число полей в пользовательском файле. Даже если предполагается массовое копирование данных из пользовательского файла в таблицу SQL Server и не предполагается копирование всех полей в пользовательском файле, аргументу nColumns следует присвоить значение, равное общему числу полей в пользовательском файле. Затем с помощью свойства BCPColFmtможно указать поля, которые нужно пропустить.
Значения кода возврата
S_OK
Метод выполнен успешно.
E_FAIL
Произошла ошибка, связанная с поставщиком. Подробные сведения можно получить при помощи интерфейса ISQLServerErrorInfo.
E_UNEXPECTED
Непредвиденный вызов метода. Например, перед вызовом этого метода не был вызван метод BCPInit . Это значение возвращается также, если данный метод был вызван несколько раз для операции массового копирования.
E_OUTOFMEMORY
Недостаточно памяти.
См. также
IBCPSession (OLE DB)
Выполнение операций массового копирования