IBCPSession::BCPWriteFmt (OLE DB)

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

Sintaxe

HRESULT BCPWriteFmt( 
      const wchar_t *pwszFormatFile);

Comentários

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 xml ou formato 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.

Observação
O arquivo de formato gerado pelo método BCPWriteFmt só é suportado por versões do utilitário bcp distribuídas com o SQL Server versão 7.0 ou posterior.

Argumentos

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

Valores de 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 esse método ser chamado.

Consulte também

Conceitos

Executando operações de cópia em massa

Outros recursos

IBCPSession (OLE DB)