Partilhar via


bcp_colptr

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

Define o endereço de dados da variável de programa para a cópia atual no SQL Server.

Sintaxe

  
RETCODE bcp_colptr (  
        HDBC hdbc,  
        LPCBYTE pData,  
        INT idxServerCol);  

Argumentos

hdbc
É o identificador de conexão ODBC habilitado para cópia em massa.

pData
É um ponteiro para os dados a serem copiados. Se o tipo de dados associado for um tipo de valor grande (como SQLTEXT ou SQLIMAGE), pData poderá ser NULL. Um pData NULL indica que valores de dados longos serão enviados ao SQL Server em partes usando bcp_moretext.

Se pData for definido como NULL e a coluna correspondente ao campo associado não for um tipo de valor grande, bcp_colptr falhará.

Para obter mais informações sobre tipos de valor grandes, consulte bcp_bind.

idxServerCol
É a posição ordinal da coluna na tabela do banco de dados na qual os dados são copiados. A primeira coluna em uma tabela é a coluna 1. A posição ordinal de uma coluna é relatada por SQLColumns.

Devoluções

SUCCEED ou FAIL.

Comentários

A função bcp_colptr permite que você altere o endereço dos dados de origem de uma coluna específica ao copiar dados para o SQL Server com bcp_sendrow.

Inicialmente, o ponteiro para os dados do usuário é definido por uma chamada para bcp_bind. Se o endereço de dados da variável de programa for alterado entre chamadas para bcp_sendrow, você poderá chamá bcp_colptr para redefinir o ponteiro para os dados. A próxima chamada para bcp_sendrow envia os dados endereçados pela chamada para bcp_colptr.

Deve haver uma chamada de bcp_colptr separada para cada coluna na tabela cujo endereço de dados você deseja modificar.

Confira também

Funções de cópia em massa