Partager via


bcp_colptr

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Définit l’adresse de données de variable de programme pour la copie actuelle 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 un type de valeur volumineux (par exemple, SQLTEXT ou SQLIMAGE), pData peut être NULL. Un pData NULL indique que les valeurs de données longues sont envoyées à SQL Server en blocs à l’aide de bcp_moretext.

Si pData est défini sur NULL et que la colonne correspondant au champ lié n’est pas un type de valeur volumineux, bcp_colptr échoue.

Pour plus d’informations sur les types de valeurs volumineux, 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 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 bcp_colptr distinct pour chaque colonne de la table dont vous souhaitez modifier l’adresse de données.

Voir aussi

Fonctions de copie en bloc