IBCPSession::BCPWriteFmt (OLE DB)

Grava informações de formato para cada coluna no arquivo de formato.

Sintaxe

  
HRESULT BCPWriteFmt(   
const wchar_t *pwszFormatFile);  

Observações

O arquivo de formato especifica o formato de dados de um arquivo de dados criado por cópia em massa. Chamadas para os métodos IBCPSession::BCPColumns e IBCPSession::BCPColFmt definem o formato do arquivo de dados. O método BCPWriteFmt salva essa definição no arquivo referenciado pelo argumento pwszFormatFile.

O método BCPWriteFmt pode salvar os arquivos de formato em formato xml ou de texto. Isso deve ser indicado usando a opção de controle BCP_OPTION_XML com o método IBCPSession::BCPControl .

Para carregar um arquivo de formato salvo, use o método IBCPSession::BCPReadFmt .

Argumentos

pwszFormatFile[in]
O caminho e o nome do arquivo que contém os valores de formato do arquivo de dados.

Valores do código de retorno

S_OK
O método foi bem-sucedido.

E_FAIL
Ocorreu um erro específico do provedor; para obter informações detalhadas, use a interface ISQLServerErrorInfo .

E_OUTOFMEMORY
Erro de memória insuficiente.

E_UNEXPECTED
A chamada para o método era inesperada. Por exemplo, o método IBCPSession::BCPInit não foi chamado antes de chamar esse método.

Consulte Também

IBCPSession (OLE DB)
Executando operações de cópia em massa