Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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
);
Les arguments
hdbc
Handle de connexion ODBC compatible avec la copie en bloc.
cbData
Longueur des données dans la variable de programme, sans inclure la longueur d’un indicateur de longueur ou d’un indicateur de fin. La définition de cbData sur SQL_NULL_DATA indique que toutes les lignes copiées sur le serveur contiennent une valeur NULL pour la colonne. La définition de la valeur SQL_VARLEN_DATA indique qu’une marque de fin de chaîne ou une autre méthode est utilisée pour déterminer la longueur des données copiées. S’il existe à la fois un indicateur de longueur et un indicateur de fin, le système utilise le cas échéant moins de données copié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 signalée par SQLColumns.
Retours
SUCCEED ou FAIL.
Remarques
La fonction bcp_collen vous permet de modifier la longueur des 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 des données est déterminée quand bcp_bind est appelée. Si la longueur des données change entre les appels à bcp_sendrow et qu’aucun préfixe de longueur ni fin n’est utilisé, 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 souhaitez modifier la longueur des données.