Compartilhar via


IBCPSession::BCPColumns (OLE DB)

Define o número de campos que devem ser associados às colunas de uma tabela do SQL Server.

Sintaxe

HRESULT BCPColumns( 
      DBCOUNTITEM nColumns);

Comentários

Internamente, ele chama IBCPSession::BCPColFmt para definir os valores padrão para dados de campo. Esses valores padrão são obtidos com as informações de coluna do SQL Server que o provedor recupera internamente quando o nome de tabela é especificado através de IBCPSession::BCPInit.

ObservaçãoObservação

Esse método só pode ser chamado depois que BCPInit foi chamado com um nome de arquivo válido.

Você só deve chamar esse método se pretender usar um formato de arquivo de usuário diferente do padrão. Para obter mais informações sobre uma descrição do formato de arquivo de usuário padrão, consulte o método BCPInit.

Depois de chamar o método BCPColumns, você precisa chamar o método BCPColFmt para cada coluna no arquivo de usuário para definir completamente um formato de arquivo personalizado.

Argumentos

  • nColumns[in]
    O número total de campos no arquivo de usuário. Mesmo se você estiver se preparando para copiar em massa os dados do arquivo de usuário para uma tabela do SQL Server e não pretender copiar todos os campos no arquivo de usuário, ainda assim será necessário definir o argumento nColumns como o número total de campos de arquivo de usuário. Os campos ignorados podem ser especificados através de BCPColFmt.

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_UNEXPECTED
    A chamada para o método era inesperada. Por exemplo, o método BCPInit não foi chamado antes da chamada desse método. Também ocorre quando esse método é chamado mais de uma vez para uma operação de cópia em massa.

  • E_OUTOFMEMORY
    Erro de memória insuficiente.

Consulte também

Conceitos

Outros recursos