IBCPSession::BCPWriteFmt (OLE DB)

  • Artigo

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çãoObservaçã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 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)