bcp_colptr

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 des données liées est un type de grande valeur (tel que SQLTEXT ou SQLIMAGE), pData peut être Null. Un pData Null indique que des valeurs de données longues seront envoyées à SQL Server par segments à l'aide de bcp_moretext.

  Si pData a la valeur Null et que la colonne qui correspond au champ lié n'est pas un type de grande valeur, bcp_colptr échoue.

  Pour plus d'informations sur les types de grandes valeurs, 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.

Valeur renvoyée

SUCCEED ou FAIL.

Notes

La fonction bcp_colptr vous permet de modifier l'adresse des données sources pour 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 des 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 adressées par l'appel à bcp_colptr.

Il doit y avoir un appel bcp_colptr séparé pour chaque colonne dans la table dont vous souhaitez modifier l'adresse des données.

Voir aussi

Référence