bcp_colptr

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

Define o endereço de dados da variável do programa para a cópia atual em 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 para 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.

Retornos

SUCCEED ou FAIL.

Comentários

A função bcp_colptr permite alterar o endereço dos dados de origem de uma coluna específica ao copiar dados para 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 do programa for alterado entre chamadas para bcp_sendrow, você poderá chamar 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 bcp_colptr separada para cada coluna na tabela cujo endereço de dados você deseja modificar.

Consulte Também

Bulk Copy Functions