bcp_colptr

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 se van a copiar. 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 de la tabla de base de datos a la que se copian los datos. La primera columna de una tabla es la columna 1. SQLColumns notifica la posición ordinal de una columna.

Devoluciones

SUCCEED o FAIL.

Observaciones

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 bcp_colptr independiente para cada columna de la tabla cuya dirección de datos desea modificar.

Véase también

Funciones de copia masiva