Поделиться через


IBCPSession::BCPColumns (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
    Недостаточно памяти.

См. также

Основные понятия

Другие ресурсы