IBCPSession::BCPReadFmt (Fornecedor Nativo de Cliente OLE DB)

Aplica-se a:SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse Analytics

Lê a informação de formato de cada coluna a partir do ficheiro de formato.

Syntax

  
HRESULT BCPReadFmt(   
      const wchar_t *pwszFormatFile);  

Observações

O método BCPReadFmt é utilizado para ler dados a partir de um ficheiro de formato que especifica o formato dos dados no ficheiro de dados. Este método é capaz de detetar a versão correta do ficheiro de formatação. Consegue detetar automaticamente se o ficheiro de formato está em formato xml ou texto antigo e comporta-se em conformidade. As versões de ficheiro de formato suportadas pelo fornecedor de base de dados SQL Server Native Client OLE DBP, BCP, são versões 6.0 ou mais recentes.

Depois de o método BCPReadFmt ler os valores de formato, faz as chamadas apropriadas para os métodos IBCPSession::BCPColumns e IBCPSession::BCPColFmt. Não é necessário que o utilizador analise um ficheiro de formato e faça estas chamadas.

Para guardar um ficheiro de formatação, chame o método IBCPSession::BCPWriteFmt. As chamadas ao método BCPReadFmt podem referenciar formatos guardados. Em alternativa, a utilidade de cópia em massa (bcp) pode guardar formatos de dados definidos pelo utilizador em ficheiros 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.

Arguments

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

Valores do código de retorno

S_OK
O método teve sucesso.

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

E_OUTOFMEMORY
Erro de falta de memória.

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

Conteúdo relacionado

• IBCPSession (Fornecedor de Base de Dados OLE de Cliente Nativo)
• Realização de Operações de Cópia em Massa no Cliente Nativo do SQL Server