IBCPSession::BCPColumns (OLE DB)

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Скачать драйвер OLE DB

Задает количество полей, привязанных к столбцам в таблице 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)
Выполнение операций массового копирования