Partager via


bcp_collen

Définit la longueur des données dans la variable de programme pour la copie en bloc actuelle dans SQL Server.

Syntaxe

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

Arguments

  • hdbc
    Is the bulk copy-enabled ODBC connection handle.

  • cbData
    Longueur des données dans la variable de programme, à l'exclusion de la longueur de tout indicateur de longueur ou terminateur. La définition de cbData avec la valeur SQL_NULL_DATA indique que toutes les lignes copiées sur le serveur contiennent une valeur NULL pour la colonne. La définition de cbData avec la valeur SQL_VARLEN_DATA indique qu'un terminateur de chaîne ou une autre méthode est utilisé pour déterminer la longueur des données copiées. S'il existe à la fois un indicateur de longueur et un terminateur, le système utilise celui qui entraîne la copie du moins grand nombre de données.

  • idxServerCol
    Position ordinale de la colonne dans la table vers laquelle les données sont copiées. La première colonne est 1. La position ordinale d'une colonne est indiquée par SQLColumns.

Valeurs retournées

SUCCEED ou FAIL.

Notes

La fonction bcp_collen vous permet de modifier la longueur de données dans la variable de programme pour une colonne particulière lors de la copie de données vers SQL Server avec bcp_sendrow.

Initialement, la longueur de données est déterminée quand bcp_bind est appelé. Si la longueur de données change entre des appels à bcp_sendrow et qu'aucun préfixe de longueur ou terminateur n'est en cours d'utilisation, vous pouvez appeler bcp_collen pour réinitialiser la longueur. L'appel suivant à bcp_sendrow utilise la longueur définie par l'appel à bcp_collen.

Vous devez appeler bcp_collen une fois pour chaque colonne de la table dont vous voulez modifier la longueur de données.

Voir aussi

Référence

Fonctions de copie en bloc