IBCPSession::BCPReadFmt (OLE DB)
Считывает сведения о формате для каждого столбца из файла форматирования.
Синтаксис
HRESULT BCPReadFmt( const wchar_t *pwszFormatFile);
Замечания
Метод BCPReadFmt используется для считывания данных из файла форматирования, указывающего формат данных в файле данных. Данный метод способен определить правильную версию файла форматирования. Он может автоматически определить, в каком формате находится файл форматирования — XML или формат текста по старому стилю, и действовать соответствующим образом. Программа BCP поставщика OLE DB собственного клиента SQL Server поддерживает версии файла форматирования 6.0 и следующие.
После того как метод BCPReadFmt считывает значения формата, он выполняет соответствующие вызовы методов IBCPSession::BCPColumns и IBCPSession::BCPColFmt. Пользователю не требуется производить анализ файла форматирования и выполнять эти вызовы.
Чтобы сохранить файл форматирования вызовите метод IBCPSession::BCPWriteFmt. Вызовы метода BCPReadFmt могут ссылаться на сохраненные форматы. Кроме того, программа массового копирования (bcp) может сохранять определяемые пользователем форматы данных в файлах, на которые может ссылаться метод BCPReadFmt.
Аргументы
- pwszFormatFile[in]
Путь и имя файла, содержащего значения формата для файла данных.
Значения кода возврата
S_OK
Метод выполнен успешно.E_FAIL
Произошла ошибка, связанная с поставщиком. Подробные сведения можно получить при помощи интерфейса ISQLServerErrorInfo.E_OUTOFMEMORY
Ошибка, связанная с нехваткой памяти.E_UNEXPECTED
Непредвиденный вызов метода. Например, перед вызовом этого метода не был вызван метод IBCPSession::BCPInit.
См. также