bcp_colptr
Définit l’adresse de données de la variable de programme pour la copie active dans SQL Server.
Syntaxe
RETCODE bcp_colptr (
HDBC
hdbc
,
LPCBYTE
pData
,
INT
idxServerCol
);
Arguments
hdbc
Handle de connexion ODBC compatible avec la copie en bloc.
Pdata
Pointeur vers les données à copier. Si le type de données lié est de type grande valeur (par exemple, SQLTEXT ou SQLIMAGE), pData peut avoir la valeur NULL. Un pData NULL indique que les valeurs de données longues seront envoyées à SQL Server en blocs à l’aide de bcp_moretext.
Si pData a la valeur NULL et que la colonne correspondant au champ lié n’est pas un type de grande valeur, bcp_colptr échoue.
Pour plus d’informations sur les types à valeur élevée, consultez bcp_bind.
idxServerCol
Position ordinale de la colonne dans la table de base de données vers laquelle les données sont copiées. La première colonne d'une table est la colonne 1. La position ordinale d'une colonne est indiquée par SQLColumns.
Retours
SUCCEED ou FAIL.
Notes
La fonction bcp_colptr vous permet de modifier l’adresse des données sources d’une colonne particulière lors de la copie de données vers SQL Server avec bcp_sendrow.
Initialement, le pointeur vers les données utilisateur est défini par un appel à bcp_bind. Si l’adresse de données de la variable de programme change entre les appels à bcp_sendrow, vous pouvez appeler bcp_colptr pour réinitialiser le pointeur vers les données. L’appel suivant à bcp_sendrow envoie les données traitées par l’appel à bcp_colptr.
Il doit y avoir un appel de bcp_colptr distinct pour chaque colonne de la table dont vous souhaitez modifier l’adresse de données.