IBCPSession::BCPWriteFmt (OLE DB)

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

Синтаксис

  
HRESULT BCPWriteFmt(   
const wchar_t *pwszFormatFile);  

Замечания

Файл форматирования определяет формат данных, содержащихся в файле данных, создаваемом при массовом копировании. Вызовы методов IBCPSession::BCPColumns и IBCPSession::BCPColFmt определяют формат файла данных. Метод BCPWriteFmt сохраняет это определение в файле, на который ссылается аргумент pwszFormatFile.

Метод BCPWriteFmt может сохранять файлы формата в формате XML или текстовом формате. Это должно быть указано с помощью параметра управления BCP_OPTION_XML с методом IBCPSession::BCPControl .

Чтобы загрузить сохраненный файл формата, используйте метод IBCPSession::BCPReadFmt .

Аргументы

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

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

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

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

E_OUTOFMEMORY (Ошибка: Недостаточно памяти)
Ошибка вне памяти.

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

См. также

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