bcp_colptr
Define o endereço de dados variáveis do programa da 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. Caso o tipo de dados associado seja grande (como, por exemplo, SQLTEXT ou SQLIMAGE), pData pode ser NULL. Um pData NULL indica que valores de dados longos serão enviados para o SQL Server em trechos usando bcp_moretext.Caso pData seja definido como NULL, e a coluna correspondente ao campo associado não seja um tipo de valor grande, há uma falha em bcp_colptr.
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.
Retorna
SUCCEED ou FAIL.
Comentários
A função bcp_colptr permite alterar o endereço de dados de origem de uma coluna específica ao copiar dados para o SQL Server com bcp_sendrow.
Inicialmente, o ponteiro para dados de usuário é definido por uma chamada como bcp_bind. Caso o endereço dos dados variáveis do programa seja alterado entre chamadas para bcp_sendrow, você pode chamar bcp_colptr para reiniciar o ponteiro nos 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 todas as colunas na tabela cujos endereços de dados você deseja modificar.