Compartilhar via


IBCPSession::BCPReadFmt (OLE DB)

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

Sintaxe

HRESULT BCPReadFmt( 
      const wchar_t *pwszFormatFile);

Comentários

O método BCPReadFmt é usado para ler dados de um arquivo de formato que especifica o formato de dados no arquivo de dados. Este método é capaz de detectar a versão correta do arquivo de formato. Ele pode detectar automaticamente se o arquivo de formato está em xml ou formato de texto de estilo antigo e se comporta adequadamente. O BCP do provedor OLE DB do SQL Server Native Client dá suporte às versões 6.0 ou mais recentes dos arquivos de formato.

Depois que o método BCPReadFmt ler os valores de formato, fará as chamadas apropriadas aos métodos IBCPSession::BCPColumns e IBCPSession::BCPColFmt. Não há necessidade de o usuário analisar um arquivo de formato e fazer essas chamadas.

Para salvar um arquivo de formato, chame o método IBCPSession::BCPWriteFmt. As chamadas ao método BCPReadFmt podem referenciar formatos salvos. Como alternativa, o utilitário de cópia em massa (bcp) pode salvar formatos de dados definidos pelo usuário em arquivos que podem ser referenciados pelo método BCPReadFmt.

O valor BCP_OPTION_DELAYREADFMT do parâmetro eOption de IBCPSession::BCPControl modifica o comportamento de IBCPSession::BCPReadFmt.

Argumentos

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

Valores de código de retorno

  • S_OK
    O método foi bem-sucedido.

  • E_FAIL
    Um erro específico do provedor ocorreu. 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)