bcp_colptr

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Establece la dirección de datos de la variable 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 grandes, 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 variable del 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 direccionado 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.

Consulte también

Bulk Copy Functions