Compartir a través de


bcp_collen

Establece la longitud de los datos de la variable del programa para la copia masiva actual en SQL Server.

Sintaxis

RETCODE bcp_collen (
        HDBC hdbc,
        DBINT cbData,
        INT idxServerCol);

Argumentos

  • hdbc
    Es el identificador de la conexión ODBC habilitada para la copia masiva.

  • cbData
    Es la longitud de los datos de la variable del programa; no incluye la longitud del indicador ni del terminador de longitud. Si se establece cbData en SQL_NULL_DATA, se indica que todas las filas copiadas en el servidor contienen un valor NULL para la columna. Si se establece en SQL_VARLEN_DATA, se indica que se utiliza un terminador de cadena u otro método para determinar la longitud de los datos copiados. Si hay un indicador y un terminador de longitud, el sistema utiliza el que permita que se copien menos datos.

  • idxServerCol
    Es la posición ordinal de la columna en la tabla en la que se copian los datos. La primera columna es 1. La posición ordinal de una columna se notifica mediante SQLColumns.

Devuelve

SUCCEED o FAIL.

Notas

La función bcp_collen permite cambiar la longitud de los datos en la variable del programa para una determinada columna al copiar los datos en SQL Server con bcp_sendrow.

La longitud de los datos se determina inicialmente cuando se llama a bcp_bind. Si la longitud de los datos cambia entre las llamadas a bcp_sendrow y no se utiliza ningún prefijo o terminador de longitud, puede llamar a bcp_collen para restablecer la longitud. La llamada siguiente a bcp_sendrow utiliza la longitud establecida por la llamada a bcp_collen.

Debe llamar una vez a bcp_collen para cada columna de la tabla cuya longitud de los datos desee modificar.

Vea también

Referencia