bcp_colptr
Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Establece la dirección de datos de variables de programa para la copia actual en SQL Server.
Sintaxis
RETCODE bcp_colptr (
HDBC hdbc,
LPCBYTE pData,
INT idxServerCol);
Argumentos
hdbc
Es el identificador de la conexión ODBC habilitada para la copia masiva.
pData
Es un puntero a los datos que van a copiarse. Si el tipo de datos enlazado es de gran tamaño (como SQLTEXT o SQLIMAGE), pData puede ser NULL. Un valor pData NULL indica que los valores de datos largos se enviarán a SQL Server en fragmentos mediante bcp_moretext.
Si pData se establece en NULL y la columna correspondiente al campo enlazado no es un tipo de valor grande, bcp_colptr produce un error.
Para obtener más información sobre los tipos de valor grande, consulte bcp_bind.
idxServerCol
Es la posición ordinal de la columna en la tabla de base de datos en la que se copian los datos. La primera columna de una tabla es la columna 1. La posición ordinal de una columna se notifica mediante SQLColumns.
Devoluciones
SUCCEED o FAIL.
Comentarios
La función bcp_colptr permite cambiar la dirección de los datos de origen de una columna determinada al copiar datos en SQL Server con bcp_sendrow.
Inicialmente, el puntero a los datos de usuario se establece mediante una llamada a bcp_bind. Si la dirección de datos de la variable de programa cambia entre las llamadas a bcp_sendrow, puede llamar a bcp_colptr para restablecer el puntero a los datos. La siguiente llamada a bcp_sendrow envía los datos dirigidos por la llamada a bcp_colptr.
Debe haber una llamada de bcp_colptr independiente para cada columna de la tabla cuya dirección de datos desea modificar.