IBCPSession::BCPColumns (поставщик OLE DB собственного клиента)

Статья
07/04/2024

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

Внимание

Собственный клиент SQL Server (часто сокращенный SNAC) был удален из SQL Server 2022 (16.x) и SQL Server Management Studio 19 (SSMS). Поставщик OLE DB собственного клиента SQL Server (SQLNCLI или SQLNCLI11) и устаревший поставщик Microsoft OLE DB для SQL Server (SQLOLEDB) не рекомендуется для новой разработки. Перейдите на новый драйвер Microsoft OLE DB (MSOLEDBSQL) для SQL Server .

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

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