IBCPSession::BCPReadFmt (OLE DB)

Lê informações de formato para cada coluna do arquivo de formato.

Sintaxe

  
HRESULT BCPReadFmt(   
const wchar_t *pwszFormatFile);  

Observações

O método BCPReadFmt é usado para ler dados de um arquivo de formato que especifica o formato de dados no arquivo de dados. Esse método é capaz de detectar a versão correta do arquivo de formato. Ele pode detectar automaticamente se o arquivo de formato está no formato de texto xml ou antigo e se comporta adequadamente. As versões de arquivo de formato compatíveis com o BCP do provedor OLE DB do SQL Server Native Client são versões 6.0 ou mais recentes.

Depois que o método BCPReadFmt lê os valores de formato, ele faz as chamadas apropriadas para os métodos IBCPSession::BCPColumns e IBCPSession::BCPColFmt . Não é necessário que o usuário analise um arquivo de formato e faça essas chamadas.

Para salvar um arquivo de formato, chame o método IBCPSession::BCPWriteFmt . Chamadas para o 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 BCP_OPTION_DELAYREADFMT valor 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 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 foi 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