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

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

Define o número de campos que devem ser atribuídos às colunas de uma tabela SQL Server.

Syntax

  
HRESULT BCPColumns(   
      DBCOUNTITEM nColumns);  

Observações

Internamente, chama IBCPSession::BCPColFmt para definir os valores padrão dos dados de campo. Estes valores por defeito são obtidos a partir da informação da coluna SQL Server que o fornecedor recupera internamente quando o nome da tabela é especificado através do IBCPSession::BCPInit.

Deve chamar este método apenas se pretender usar um formato de ficheiro de utilizador diferente do padrão. Para mais informações sobre uma descrição do formato padrão de ficheiro de utilizador, consulte o método BCPInit .

Depois de chamar o método BCPColumns , deve chamar o método BCPColFmt para cada coluna no ficheiro de utilizador para definir completamente um formato de ficheiro personalizado.

Arguments

nColunas[em]
O número total de campos no ficheiro do utilizador. Mesmo que esteja a preparar-se para copiar em massa dados do ficheiro de utilizador para uma tabela SQL Server e não pretenda copiar todos os campos do ficheiro de utilizador, deve ainda assim definir o argumento nColumns para o número total de campos do ficheiro de utilizador. Os campos saltados podem então ser especificados através do BCPColFmt.

Valores do código de retorno

S_OK
O método teve sucesso.

E_FAIL
Ocorreu um erro específico do fornecedor; 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 era chamado antes de chamar este método. Também ocorre quando este método é chamado mais do que uma vez para uma operação de cópia em massa.

E_OUTOFMEMORY
Erro de falta de memória.

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