IBCPSession::BCPReadFmt (OLE DB)
Применимо: 
SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)
Считывает сведения о формате для каждого столбца из файла форматирования.
Синтаксис
HRESULT BCPReadFmt(
const wchar_t *pwszFormatFile);
Замечания
Метод 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)
Выполнение операций массового копирования