bcp_colptr

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 un tipo de valor grande (como SQLTEXT o SQLIMAGE), pData puede ser NULL. Si el valor de pData es NULL, significa que los valores de datos largos se enviarán a SQL Server en fragmentos utilizando bcp_moretext.

  Si el valor de pData está establecido en NULL y la columna correspondiente al campo enlazado no es un tipo de valor grande, se produce un error en bcp_colptr.

  Para obtener más información sobre los tipos de valor grandes, vea 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.

Devuelve

SUCCEED o FAIL.

Notas

La función bcp_colptr le permite cambiar la dirección de los datos de origen de una columna en particular cuando los datos se copian en SQL Server con bcp_sendrow.

Inicialmente, el puntero a los datos del usuario se establece mediante una llamada a bcp_bind. Si la dirección de datos de la variable de programa cambia entre las distintas llamadas a bcp_sendrow, es posible 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 a bcp_colptr independiente para cada columna de la tabla cuya dirección de datos desee modificar.

Vea también

Referencia