Метод IBCPSession::BCPReadFmt (OLE DB)

Статья
05/23/2023

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

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

Считывает сведения о формате для каждого столбца из файла форматирования.

Синтаксис

  
HRESULT BCPReadFmt(   
      const wchar_t *pwszFormatFile);

Remarks

Метод BCPReadFmt используется для считывания данных из файла форматирования, указывающего формат данных в файле данных. Данный метод способен определить правильную версию файла форматирования. Он может автоматически определить, в каком формате находится файл форматирования — XML или формат текста по старому стилю, —и действовать соответствующим образом. Программа BCP, предоставляемая в OLE DB Driver for SQL Server, поддерживает файлы форматирования версии 6.0 и более новых версий.

После того как метод BCPReadFmt считывает значения формата, он выполняет соответствующие вызовы методов IBCPSession::BCPColumns и IBCPSession::BCPColFmt. Пользователю не требуется производить анализ файла форматирования и выполнять эти вызовы.

Чтобы сохранить файл форматирования, вызовите метод IBCPSession::BCPWriteFmt. Вызовы метода BCPReadFmt могут ссылаться на сохраненные форматы. Кроме того, программа массового копирования (bcp) может сохранять определяемые пользователем форматы данных в файлах, на которые может ссылаться метод BCPReadFmt .

Значение BCP_OPTION_DELAYREADFMT для параметра eOption в IBCPSession::BCPControl изменяет поведение IBCPSession::BCPReadFmt.

Аргументы

pwszFormatFile[in]
Путь и имя файла, содержащего значения формата для файла данных.

Значения кода возврата

S_OK
Метод выполнен успешно.

E_FAIL
Произошла ошибка, связанная с поставщиком. Подробные сведения можно получить с помощью интерфейса ISQLServerErrorInfo.

E_OUTOFMEMORY
Ошибка, связанная с нехваткой памяти.

E_UNEXPECTED
Непредвиденный вызов метода. Например, перед вызовом этого метода не был вызван метод IBCPSession::BCPInit.

См. также:

Интерфейс IBCPSession (OLE DB)
Выполнение операций массового копирования

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