IBCPSession::BCPColumns (OLE DB)

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

Sintaxe

  
HRESULT BCPColumns(   
DBCOUNTITEMnColumns);  

Observações

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

Você deve chamar esse método somente 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ê deve 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 dados em massa do arquivo de usuário para uma tabela do SQL Server e não pretende copiar todos os campos no arquivo de usuário, você ainda deve definir o argumento nColumns como o número total de campos de arquivo de usuário. Os campos ignorados podem ser especificados por meio de BCPColFmt.

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_UNEXPECTED
A chamada para o método foi inesperada. Por exemplo, o método BCPInit não foi chamado antes de chamar esse 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

IBCPSession (OLE DB)
Executando operações de cópia em massa